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PREFACE 



This reference document discusses the principles, features, methods, rules and techniques of producing a CONTROL 
DATA® STAR Assembler Language program. 

The reader is encouraged to study the subject matter in the order presented: 



section 1 

Section 2 

Section 3 
Section 4 

Section 5 

Appendix A 

Appendix B 

Appendix C 

Appendix D 
Appendix E 

Appendix F 
Appendix G 



introduction — Introduces features of the STAR Assembler considered most 
important. 

Program Structure — Discusses the structure of a typical assembler program and 
introduces the assembler coding conventions. 

Statement Structure — Describes all assembler statement organization and rules. 

Directives - Details all available assembler directives and the organization of 
assembler procedures and functions. A directive summary is also provided. 

Assembler Provided Functions and Procedures - Details all functions and procedures 
provided as part of the STAR Assembler. 

Elementary Items — Describes the data types permitted for use with the assembly 
language. 

Expression — Describes the types of expressions permitted for use with the assembly 
language. 

STAR Machine Instructions - Provides a more than cursory discussion of the 
machine instruction types and includes a summary list of all machine instructions 
with format and function descriptions. 

JOB Processing Deck Structure 

Assembly Listing Format - Describes and illustrates the format of an assembly 
hsting. 

Error Messages — lists all error messages produced by the assembler. 

Predefined Symbols - Lists all predefined assembler symbols, their values, and use. 
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Appendix H Assembly Limitations — Lists assembler limitations. 

Appendix I Examples - Sample program descriptions. 

Information supporting this document is given in the following publications: 

STAR- 100 Hardware Reference Manual Pub. No. 60256000 
STAR-65 Hardware Reference Manual Pub. No. 19980000 
STAR Computer System Operating System Reference Manual Pub. No. 60384400 



This product is intended for use only as described in 
this document. Control Data cannot be responsible for 
the proper functioning of undescribed features or 
undefined parameters. 
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INTRODUCTION 



The CONTROL DATA STAR Assembler is a versatile, self-extending source language and language processor 
which runs under the control of the CONTROL DATA STAR® Operating System (OS). From the source 
language subprograms, the STAR assembler generates binary output (relocatable) acceptable for loading and 
execution by the central processor under STAR OS control. 

Tlie source language consists of mnemonic machine instructions, procedures, functions, and miscellaneous 
assembler directives. With the symbolic machine instructions, all hardware functions of the STAR computer 
system may be expressed symboHcally. 

Directives allow programmer control of the assembly process. 

FEATURES 

This assembly language makes efficient use of all computer resources and provides flexibility in program con- 
struction. 

Features include: 

Simple and consistent notation. 

Procedure and function capability (provides many-for-one object code generation). 

Conditional assembly capabilities for selective assembly 

Set capability to define, reference, and extend lists of expressions 

Attribute assignment for symbols and set elements 

Mnemonic machine instructions define instructions to be generated. (Appendix C describes machine 
instructions.) 

All existing assembler routines are re-entrant to permit simultaneous use by many users and location- 
independent for fast loading. 

ASCII Code set compatibiHty 

Assignment of relocatable and absolute location counters for use in address assignment. 

Comprehensive listing of maps, diagnostics, etc. 



19980200 A 1-1 



PROCEDURES 

Procedures are assembly time subroutines that provide extensive parameterization of source statements through 
conditional assembly and many-for-one object customized generation. 

Procedures may be used for: 

Assembler instruction expansion 

Parameter checking, set generation, symbol redefinition 

Building a new language 

Saving parameters at assembly time 

Qianging instructions dynamically 

Defining tables external to each routine 

A source statement, consisting of a procedure name and parameters, calls a procedure. The assembler interprets 
the procedure and generates the equivalent STAR relocatable binary object code. Often used or standard pro- 
cedure definitions may be placed in the user defined library. 

Procedure and function definitions are groups of source statements interpreted by the assembler each time a 
procedure or function is referenced. A reference to a procedure definition appears in the command field of a 
statement; it may be likened to a macro call. A procedure is similar to a macro. 

FUNCTIONS 

Functions are assembly time subroutines used where common routines (which return a value) are desired. 
Functions and procedures are defined in a similar manner; a function reference is similar to that of a FORTRAN 
function reference. Unlike a PROC a function does not generate code but returns a value. A reference to a 
function can appear in the label, command, or operand field of an assembler statement. In general, a function 
cannot appear in the label field of a statement. Only the SYM function can be used in this manner. 

SETS/SYMBOLS 

The programmer can define and assign symbols to an address, single value, or set (list) of data. An entire set 
can be referenced by a symbol; each element of a set can be referenced by adding one or more subscripts to 
the symbol. 

Tlie assembler recognizes as operands simple and complete expressions containing any of a set of 21 operators. 
Elements of expressions can be symbols, constants expressed as integers, or real (floating point) values, accord- 
ing to convenience. 

A unique method of symbol definition allows the value of an expression to be used as a symbol. An operand 
of a source statement also can be an attribute of an expression, such as type, size, etc. 
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ATTRIBUTES 

An attribute is a property of an elementary item or expression. The assembler assigns attribute values (1-7) to 
all symbols and set elements. These intrinsic attributes are used by the assembler during syntax checks and 
expression evaluation. Through attribute referencing, the programmer can obtain information pertaining to set 
elements or expressions, such as: 

Symbol as a character string 

Mode 

Memory section location 

Definition level 

Symbolic type 

Size 

Number of elements 

The programmer also can assign extrinsic attributes that are not used by the assembler but can be referenced 
later or changed by the programmer. 

The range of the extrinsic attributes is 8-127; i.e., the programmer may assign 120 extrinsic attributes. A list of | 
intrinsic attributes, including possible values assigned by the assembler, appears in section 5. Methods of refer- 
encing intrinsic and extrinsic values and of assigning extrinsic values are given in section 5 (ATT directive) and 
section 4 (RATT function). 

BASIC PROGRAM STRUCTURE 

Source statements for an assembler program can be in one of two program areas: universal or subprogram. 
Non-executable code and statements that do not generate data can be entered in the universal area; hovi^ever, 
ail code can be written in the subprogram area with the exception of I/O directives and assembly control 
directives described in section 4. The Universal and Subprogram areas are described in section 2. 

LOCATION CONTROL 

STAR Assembler directives permit program code and data to be assigned to a maximum of 255 
subprogram control sections. Each control section has a location counter to ease the programming task of seg- 
mentation. All code and data locations are relative to the beginning of the control section and the counters 
can be incremented by words, bytes, or bits. 
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ASSEMBLY PROCESS 

The STAR Assembler is essentially a two-pass assembler; however, the number of passes depends on the exist- 
ence of the subprogram area. If the assembler is called and only a universal area exists in the source program, 
only one pass is made. If a subprogram area exists, the following occurs: 

First Pass All statements are interpreted, values are assigned to symbols, and locations are 

assigned to each statement. 

Second Pass Externals and forward references are satisfied, data generation is accomplished, 

binary output and assembly hsting are produced. Statements are interpreted during 
this pass and, if required, error and warning messages are assigned. 



OPERATING SYSTEM 

The STAR Assembler executes under control of the STAR Operating System, as described in appendix D. 

CONFIGURATION 

The requirements for executing the STAR Assembler on the STAR Computer System are the minimum required 
for the STAR Operating System. 

EXECUTION 

The assembler is called from the system library by an assembler job control command (META); see appendix D. 
Parameters in the command define files to be used during the assembler run, such as source statement files, 
listable output files and object code files. 

STANDARD INPUT 

The assembler source deck can be input from a standard card reader or a file, such as mass storage file, speci- 
fied by the programmer. For a card file, input staging transfers the deck from the standard input card reader 
onto a mass storage file. The assembler interprets one source deck statement at a time. 
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PRINTER OUTPUT 

The assembler produces printer output containing a listing of each source statement. Control directives provide 
options for obtaining a detailed listing. Errors detected by the assembler are noted on the listing. Tne output 
listing may include: 

Source Program 

Memory Map (Address Counter) 

Generated Object Code 

Diagnostics 

Cross-Reference Dsting 

Assembler diagnostics, are listed in appendix F; the assembler listing format is described in appendix E. 

EXECUTABLE OUTPUT 

Upon programmer request, the assembler opens the user specified file to receive relocatable binary output 
acceptable to the STAR relocatable loader. When the assembler has completely processed the source deck, the 
programmer can call for loading and execution of the object program from that file. The loader Unks the 
newly assembled programs referred to by a new program. 

ASSEMBLER ERROR DETECTION 

Errors detected by the assembler are indicated on the listing by an error message preceded by a field of 
asterisks; each message occupies a full lisfing line. 

SOURCE STATEMENT ERRORS 

Source statement errors are listed after the statement containing an error. The count of the number of errors, 
and a list of the line and page number of statements with errors are included in the listing after every sub- 
program. Pass one errors are Hsted after the IDENT statement for the subprogram. 

STATEMENT TERMINATING 

A statement terminating error is indicated by any error message NOT preceded by WARNING or SYSTEM 
ERROR. On detecting such an error condition, the assembler discontinues processing the current statement 
and continues with the next sequential statement. 
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WARNING MESSAGE 

Messages beginning with the word WARNING indicate a default was assumed for this error condition and 
statement processing continued. (The LISTING directive may be used to eHminate warning messages from the 
listing.) 



HARDWARE OR ASSEMBLER ERRORS 

All hardware or assembler error messages start with SYSTEM ERROR. They indicate a failure within the assem- 
bler; the assembly is aborted. 
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PRvJGRAAA STRwCTURc 






Assembler programs are written in modular form; they can consist of one or more subprograms (figure 2-1) 
which are linked and loaded together, and executed as a task. The source code for each program is assigned 
to assembler-defined program areas — universal and subprogram. These areas can contain procedures and 
functions which, for discussion purposes, can be considered subroutines. Each subprogram area can contain 
one or more code, data, and common sections. Each subprogram area produces a separate object module in 
the object file. 



X 



Subprogram 
Area 2 



I 



Universal Area 



Code Section 



Data Section 



Universal Area, 



"1 



Common Section 



Subprogram Areag 
same as Subprogram Area^ 




T 



Universal Area 



I/O Parameters; and Symbol, 
Form, and Procedure Defini- 
tions for all subprograms* 



n 



J 



Source Statements 

SOURCE DECK • 
NON EXECUTABLE CODE 
IDENT ' ■ 

SUBPROGRAM I 

END 

NON EXECUTABLE CODE 
(if required) 

IDENT 



SUBPROGRAM II 



END 
TTNTS 



Figure 2-1 . Program Structure 
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ASSEMBLER CODE CONVENTIONS 

All code (except data and common section code) must be location-independent. Such code consists of a sequ- 
ence of statements without virtual address references (relative references are permitted). This code is written to 
execute correctly from any location in virtual memory and combines the benefits of absolute code (fast load- 
ing) with that of relocatable code (can be loaded at any location). 

Assembler code also must be re-entrant; it must never modify itself. Re-entrance permits the simultaneous use 
of the same code by more than one task in the user program. Re-entrant code is obtained by separating the 
code from data modified by the code. 

Examples of location-independent and re-entrant code and the solution to some programming problems which 
result from these conventions are provided in appendix I. 



PROGRAM UNIVERSAL AREA 

The universal area is located before the first IDENT statement of the subprogram area (when a program con- 
sists of one subprogram) between the END statement of a subprogram area and the IDENT statement of the 
following subprogram area (when a program consists of more than one subprogram). Statements in the universal 
area specify input/output parameters and define symbols, procedures, functions, and sets to be referenced by 
statements following the subprogram areas which follow. 

Procedures (section 4) are assembly-time (only) subroutines that generate customized code or data. Only one 
copy of a procedure is required regardless of how many times it is to be called within a program. Functions 
(section 4) are also assembly-time (only) subroutines normally used when common subroutines are required. 
Functions, unlike procedures, return a value, and cannot generate code. 

The STAR assembler is essentially a two-pass assembler; however, in the universal area only one complete pass 
is made per assembly. Code or data cannot be generated in the universal area. Forward references (section 4) 
or statements which affect location counters (FORM references, MSEC) are not permitted. A reference to a 
symbol (appendix A) or set of elements (set name and a list of expressions) before it is defined is termed a 
forward reference. A reference to a numeric label is not considered a forward reference. 

Definition level 1 is assigned to the universal area. All symbols defined in this area are assigned a definition 
level attribute of I. All identifiers and names defined in a procedure or function and located in the universal 
area are assigned a definition level of 3 or greater depending on the nested call level. Each nest of a procedure 
or function call increases the definition level by 1 . Symbol level definition and referencing is described at the 
end of this section. 
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SUBPROGRAM AREA 

The subprogram area consists of statements between the IDENT and END directives. Tlie subprogram area can 
consist of one or more user-specified memory control sections which can contain: code (code section) and 
associated data, data (data section) to be shared by more than one subprogram, and common data shared be- 
tween two or more separately assembled programs. These memory control sections are assigned through the 
MSEC directive or by default as described in section 4. 

In the assembler object file output, locations of code and data sections of a user program are non-contiguous. 
However at load time, these areas are linked through the register file; the STAR loader allocates contiguous 
locations for all common sections. 

All assembler directives can be used in the subprogram area except the INPUT, OUTPUT, LISTING, IDENT, 
and FINIS directives. Forward references to non- rede finable symbols are permitted; however, forward refer- 
ences to function names, procedure names, form names and rede finable symbols are not permitted. 

The subprogram area is assigned definition level 2; therefore, symbols not defined in a procedure or function 
are assigned a definition level attribute of 2 unless they are declared external. Symbols defined in a subprogram 
area procedure or function are assigned a definition level of 3 or greater depending on the nested call level of 
the procedure or function. Each nest of a procedure or function call increases the definition level by 1. 

The subprogram area is two pass, therefore it does not permit nested forward references because an additional 
pass is required for the resolution of each nested reference. 

CODE SECTION 

The code section consists of the executable portion of the subprogram. Code section statements must be re- 
entrant and location-independent and can contain read-only constants and instructions; external references and 
relocation references are not permitted. Read-only data is better placed in the data section, although it can be 
placed in the code section. When data is contained in the code section, it is not necessary to specify the start 
of the data section by MSEC directive. 



DATA SECTION 

The data section contains information unique to the user's program. The beginning of a data section is specified 
through the MSEC directive or through default. Relocatable and external references can be used in this area. 



COMMON SECTION 

This section consists of data which can be shared between programs assembled separately, but loaded together. 
This section is specified by the MSEC directive and contains a return address identifier. Variables, relocatable 
references, and external references are permitted here; however, symbols must not be declared as entry points. 
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LEVELS OF SYMBOL DEFINITION 

The assembler recognizes 128 levels of symbol definition: external, universal, subprogram and 125 procedure/ 
function call levels (table 2-1). 

Symbols defined at a given level always are available at that level and all higher levels, but they cannot be 
referenced from a lower level unless they are made external. Symbols outside the assembly can be declared 
external through the EXTC or EXTD directives. 

Within procedures, functions, or subprograms a dollar sign ($) appended to the symbol, when it is defined, 
changes the definition level of the symbol. At the subprogram level, the $ lowers the definition level to 1 . 
When the $ is used within a procedure or function ( or nested procedure /function), the definition level is 
lowered to 1 if the original procedure /function is called from the universal area; or it is lowered to 2 if called 
from subprogram area. 



Table 2-1 . Symbol Levels 



Level Value 



Meaning 



> 3 



Symbol is in universal area and available to all subsequent subprograms, 
functions, and procedures. 

Symbol is in subprogram area and available to all procedures and functions 
called by the subprogram. 

Symbol is in a function or procedure and available to all procedures 
and functions called by the procedure or function. 



LEVELS OF SYMBOL REFERENCE 

When a symbol is referenced, the assembler always searches for the symbol at the current level. If it is not 
found there, the assembler sequentially searches each lower level. 

A symbol defined at both the originating call level and the current level, must have a $ appended to it when 
it is referenced to return the original call level value (either the universal area or subprogram area level value). 

Symbols are defined through the SET, RDEF, or EQU directives. The RDEF directive in the following example 
illustrates the appended S. In this example, the symbol A is defined at the universal level redefined at the 
subprogram level, and referenced at the subprogram level. 



2-4 
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Example 



Universal 
area — 
(level 1) 



A 



RDEF 



Subprogram 
area — 

(level 2) 



IDENT 



A 


RDEF 


B 


RDEF 


C 


RDEF 



c 



2 

A+1 
■A$ + l 



=A=3 



:A=2 

:B=3--REFERENCES level 2 

:C=4--REFERENCES LEVEL 1 



For a second example illustrating the use of the S, see appendix I, ASSEMBLY TIME SQUARE PROCEDURE. 
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STATEMENT STRUCTURE 



The STAR assembler language source program consists of a sequence of symbolic machine instructions, 
directives, and comment lines. Input may consist of a sequence of statements punched on 80 column cards 
or entered into a source file via a terminal display console or can be resident on mass storage in binary or 
source format. 

The programmer can specify the begin, continuation, and end boundaries of each program statement through 
an assembler supplied INPUT directive or through default values. If the starting character position is not 
specified, a default value of 1 is assumed by the assembler. The assembler scans each statement as specified 
by the preceding INPUT directive or by default value. 

Similarly, the programmer specifies the last character position (end-of-column) of each statement. The maxi- 
mum value is 256; default value is 72. If a continuation for a field is specified before the end-of-column, 
the assembler scans the next line starting with default column 25 or a column specified by the INPUT 
directive. Continuation is specified by use of an ampersand (&). 

Assembler statements can contain up to four fields; the fields must be separated by one or more blanks: 

Label 

Command 

Operand 

Comment 

Each field can be as long as required. Should the length of a single field or combination thereof exceed 
2'*^"'^ field continuation must be designated by inserting an ampersand (&) in the field to be continued. 

Characters outside the statement boundaries are ignored, but the entire line image is listed by the assembler. | 

Table 3-1 describes statement format, including field restrictions. 
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Table 3-1 . Statement Format 



Format: Label, list command, list list * comments 



Label Field 


Command Field 


Operand Field 


Comment Field 


Starts at: Begin column 


Starts at: First non-blank 
character after Label field. 


Starts at: First non-blank 
character after Command 
field. 


Starts at: First non-blank 
character after Operand 
field starting with asterisk 
or any field starting with 
asterisk. 

If the first character of any 
field is an asterisk, characters 
following are considered 
comments. 




Terminated by: 


Terminated by: 

Blank 
+ End-of-Record 

End Column 


Terminated by: 

Blank 
+ End-of-Record 

End Column 


Terminated by: 
t End-of-Record 
End Column 


Blank 
+ End-of-Record 
End Column 


Format Description: 


Format Description: 
command,list 

Command can be: 
Directive 

Machine instruction 
mnemonic 

Form name 

Procedure name 

Symbol creation 
funcfion 

Optional list of elementary 
items or expressions separ- 
ated by commas. 

List elements vary with 
the command. 


Format Description: 


Format Description: 

Any ASCII character other 

than & is legal as a comment. 

& indicates continuation. 


numeric label, list 

Numeric label is optional. 

Optional list of elements 
separated by commas. 

Symbols (63 characters 
max). 

First character must 
be alphabetic 

Remaining characters 
must be A-Z, 0-9, 
or underscore. 

Set element references. 

Symbol creation 
function. 

Command field deter- 
mines legal elements 
in Hst. 


list 

Optional list is composed 
of elementary items or 
expressions separated by 
commas. 

List elements vary with 
command: 

For a directive, this 
field provides infor- 
mation required to 
perform a designated 
operation. 

For mnemonic machine 
instructions and pro- 
cedures, list represents 
addresses, constant 
values, and expressions 
to be evaluated. 



+ Unique end-of-record/line character (#1F) at the end of each source statement. This character is inserted 
by the editor or card reader. 



3-2 



19980200 A 



Examples 

The following illustrates the use of all four fields and continuation: 



7 JA G E NL 6UL 2 "GENES 



R 


A 


T 


E 


S 


A 



Column 25 

(Columns 1-3 contain numeric and symbolic labels.) 



The following statement includes a blank label field: 



|l|o|d| |d|e|c|k|Jt|i 



(There is no comment field in this statement.) 



The following includes a command and comment: 



|e|n|d| |-|c|q|m|m|e|n|t| 



The following illustrates only a comment: 

-|t| h| I |s| 1 1 |s| |a| |c| o|m|m| e|n|t 



As described in table 3-1, a label may consist of an optional numeric and symbolic list. If the numeric label 
is not used, the symbolic list starts in the start column specified by the INPUT statement or in default 
column 1. 



19980200 B 



3-3 



DIRECTIVES 



GENERAL 

A programmer using the CONTROL DATA STAR Assembler directs the assembly of object code by using a 
set of commands called directives. Directives control the operation of the assembler in much the same way as 
machine language instructions direct the computer. Through the use of directives, a programmer can: 

Define a symbol and assign a value or set of values to it for subsequent reference by the symbol. 

Specify that a symbol referenced by the program being assembled is defined externally (perhaps by a 
program previously assembled) or that it can be referred to by some other program. 

Conditionally repeat or skip source statements. 

Assign up to 255 relocatable location control counters for use by the assembler in address assignment. 

Generate code to be loaded and executed on the object computer. This process includes subdivision of 
each word to be generated into fields, and the assignment of values to the fields. 

Identify a group of statements as a function, assign one or more names to it, and use the assigned name 
as a value in an expression such that the value varies according to parameters of the function reference. 

Control the format and content of the assembly lisfing. 

Terminate assembly of subprogram or group of subprograms. 

Table 4-1 (at end of section 4) summarizes assembler directives. Examples illustrating the use of these directives 
are provided in appendix I. 

INPUT/OUTPUT CONTROL 

The following directives specify the format of assembler input and the type and format of assembler output. 
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INPUT 

The INPUT directive specifies source input format to the assembler: 
numeric-label INPUT plO,pll,pl2 * comments 

Usage 

Numeric-label is optional 

plO Specifies starting column of input record. Default is 1; plO must be greater than zero. 

pll Specifies last column to be processed. Default is 72; pll must be greater than plO plus pl2. 

pl2 Specifies starting column of continuation records. Default is 25; pl2 must be greater than zero. 

More than one INPUT directive is allowed per assembly. This directive is permitted in the Universal area only. 
Any syntax error in this statement terminates assembly. 

Example 

irjPUT ,80^25 "SCAN SPECS 

Start scanning at column 1, default. 

Scan the entire field length of 80 columns. 

Start scanning continuation records at column 25. 

OUTPUT 

The OUTPUT directive requests an object deck output: 

numeric-label OUTPUT p30 * comment 

p30 Request for a debug symbol table in the object file. If p30 has a value of 1, the debug 

symbol table is included in the object deck produced by the assembler. For any other value, 
the debug symbol table is not produced. 

The OUTPUT directive can be used only in the universal area, and only one directive per assembly is per- 
mitted. A syntax error in this statement terminates object deck creation. 

Example 

OUTPUT 

An object deck is to be created and no Debug Symbol Table Dump is requested. 
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LISTING 

Trie LISTING directive is used to request assembly listing options. 

numeric-label LISTING pl4,pl5 * comments 

pl4 Value of 1 requests a cross reference list, including all address and EQU definitions and all 

references that occur after the definition line, for example: 

B EQU A line 1 
A EQU 4 line 2 
C EQU A line 3 

The cross reference listing will indicate that A is defined on line 2 and referenced on lines 1 
and 3. Default of p 14 9^ 1 indicates no cross reference. 

pl5 Value of 1 specifies that warning messages are to be omitted from the listing. 

Syntax errors result in selection of default values. This directive is permitted only in the universal area. Only 
one LISTING directive is allowed per assembly. 

Example 

LISTING 1^1 

A cross reference list is requested and warning messages are suppressed. 

LIBP 

The library file can include PROC and Function source statements and comments. Any other statements are 
syntactically checked but not processed. A LIBP file must be a physical, mass storage file. Tape libraries are 
not permitted. 

The LIBP directive specifies library procedures and functions. A syntax error terminates this directive: 

numeric-label LIBP,pl3 HstlS * comments 

pi 3 Optional; 8-character symbol specifying the source file name. 

list 15 List of procedures or function names separated by commas. If HstlS is not used, all proce- 

dures and functions on the file will be available; otherwise, only those specified will be 
available. The list of procedure/function names must appear in the order in which they occur 
in the LIBP file. 

Up to ten library files may be specified, one per LIBP directive. 

The LIBP directive is not allowed within a procedure or function definition, and must appear in the universal 
area. 
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The following is an example of defining system parameters in a library: 

LIBP FUe XX 

PROC 

GLOBALS ^JAME 

SYSTEM$ EQU "STAR OS" 

TAPES$ EQU 5 



Main Program 



EINDP 



LIBP, XX GLOBALS 
GLOBALS 



^DEFINES SYMBOLS AT UNIVERSAL LEVEL 



LISTING CONTROL 

The following directives specify the format of the assembler listing. 

SPACING 

Selects the number of blank lines between listing lines: 

numeric-label SPACING p28 * comments 

I p28 Integer constant value of 0, 1, 2, or 3 indicates the number of blank lines to follow each 

listing line. Default is zero. 

Example 

SPACING 2 "SELECTS TWO BLANK LINES 

When a syntax error occurs the SPACING directive is ignored. A SPACING directive overrides any previous 
SPACING directives at this level. 

EJECT 

I Specifies listing is to resume at the top of the next page. EJECT can be used at all levels, 
numeric-label EJECT * comments 
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TITLE 

Places a title of up to 64 characters at the top of all succeeding pages; it also causes a listing eject. I 

numeric-label TITLE p29 * comments 

p29 "character string of no more than 64 characters" 

Example 

TITLE "ASSETIBLER LISTING" "NO COMMENTS 

MESSAGE 

Forces a character string or string expressions (maximum 128 characters) to an output listing; it overrides any 
active list control directives. I 

numeric-label MESSAGE pl6 *comments 

pl6 "character string or string expression" to be entered on the listing; if greater than 128 

characters, the string will be right truncated. 

Example 

MESSAGE "ADD_PHASE_COMPLETED" 

NOLIST 

Suppresses a Usting until a list directive is encountered, 
numeric-label NOLIST *comments 



LIST 

Restarts output listing previously suppressed by a NOLIST directive. The normal mode of assembly is LIST. 
This directive does not alter the DETAIL mode. When DETAIL mode is off, statements processed as part of 
procedures and functions are not listed. 

numeric -label LIST *comments 
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DETAIL 

DETAIL is used only at expansion time not at definition time. At call time, this directive causes a listing 
of all statements processed as part of procedures or functions. A DETAIL directive processed at any level 
initiates the listing for the current level and all lower levels, until a BRIEF directive is encountered. DETAIL 
does not initiate the LIST mode. 

numeric-label DETAIL *comments 

If a LIBP directive is encountered while in DETAIL mode, the Procedure or Function definitions contained 
in the specified file are not Usted. 

If at level 4 DETAIL is encountered and at level 5 BRIEF is encountered, only level 4 code will be expanded. 
If again at level 6 DETAIL is encountered, then level 6 code is expanded. 



Example 



01 030000000000 F 



01 oaooooooooito f 



00 000000000032 



00 000000000019 

00 000000000271 

00000000 00000271 

00 000000000032 

00 000Q000009Cit 

00000000 ooooogc* 



INPUT 1,80 
OUTPUT 
B ROEF 50 

IDENT 

DETAIL 

FUNC NUH8ER 
SQUARE NAME 
AGAIN NAME 
RESULT RDEF NUMBER{1>*NUMBER{1} 

ENDP RESULT 
B RDEF 25 
D GEN SQUARE (B) 
RESULT RDEF NUMBERC1>*NUMBER{1> 

ENDP RESULT 
C ROEF 8$ 

GEN AGAIN(C) 
RESULT RDEF NUMBERCl>»NUMBER{:i} 

ENDP RESULT 

END 



See Example 5, Appendix I for an assembly of the above example without the DETAIL directive. 



BRIEF 

Prevents the listing of statements processed as part of procedures or functions (turns off DETAIL mode). The 
I BRIEF directive does not initiate the LIST mode. The default Usting mode is BRIEF. 

numeric-label BRIEF *comments 
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ASSEMBLY CONTROL 

Tne foiiowing directives define program boundaries to the assembler: 

IDENT (used at level 1 only) 
END (used at level 2 only) 

FINIS (used at level 1 only) 

IDENT and END directives specify the beginning and end of a subprogram; FINIS specifies the end of source 
statements. 

IDENT 

numeric-label,symbol IDENT *comments 

symbol Optional name of object deck. This symbol is truncated to the first eight characters when 

the object deck is produced. The symbol is not defined (as a label) as a result of this state- I 
ment. I 

END 

numeric-label END pi *comments 

pi Optional address identifier indicating a transfer address for object deck execution. This 

identifier must have appeared previously as an entry point name in an ENTRY directive. 
(See SUBPROGRAM LINKING.) For an example of the use of this symbol, see Appendix I, 
example 8. 

This statement can be followed by another Universal Area and Subprogram area. This provides the user with 
two separate assemblies with one deck setup. However, the user must ensure that only one Universal Area 
includes an OUTPUT directive and that the last SUBPROGRAM area ends with a FINIS directive. 

FINIS 

numeric-label FINIS *comments 

FINIS terminates an assembly and must appear in the Universal level. If FINIS is encountered in a subprogram | 
area, the assembly aborts in pass 1. 

CONDITIONAL ASSEMBLY 

The user can specify the conditions which must be satisfied before a source statement or group of source 
statements can be assembled and the number of times these statements are to be processed. 
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RPT 

Specifies the number of times a statement or delimited group of source statements, following the directive, 
are to be processed: 

numeric-label,symbol RPT,p26 p27 *comments 

symbol Optional variable identifier, or expression evaluating to a variable identifier containing cur- 
rent repetition count. This identifier can be referenced and altered by the user. The initial 
value is always 1 ; it is incremented by 1 with each repetition of the succeeding source state- 
ments. Symbols can be re-used as shown in example 5. 

p26 Number of times succeeding statements are to be processed; pi must be an integer constant 

or a variable or expression which evaluates to an integer constant. If the value of p26 is zero 
or a negative, the RPT statement skips to the statement following the numeric label p27; 
p26 cannot be a forward reference (a symbol or set element referenced before it is defined). 
The value assigned to p26 upon encountering the RPT loop cannot be changed. See example 
2 below. 

p27 Forward numeric label of the last statement in the RPT loop; p27 must be an integer 

constant or a varaible or expression which evaluates to an integer constant, and not a forward 
reference. If p27 is negative or zero, an error message is given and the directive is ignored. 
Loop can be nested and have common termination statements (see example 3). 

Example 

Some directives contained in the following examples are described later in this section. 

1. A RPT, 8 1 

A RDEF A+1 

1 GEN A 

The above repeat is equivalent to: 

A RDEF 2 

GEN 2 

A RDEF 4 

GEN 4 

A RDEF 6 

GEN 6 

A RDEF 8 

GEN 8 
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A 



ECU 


4 


EOU 


5 


RPT.A.GT.B 


5 



RES, 64 
GEN 



64-12 
1,1 



The above repeat acts as a skip-to statement: 
C GEN 1^1 



because A is not greater than B. 
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GOTO 

The GOTO directive requests a conditional skip of source statements: 

numeric-label G0T0,p9 Ustl4 *comments 

p9 Must be symbol, set reference or expression with no forward references and must evaluate 

to an integer constant. p9 can specify the list elements to be selected; or it can be in the 
form of logical expressions, the validity of which determines whether a skip is executed. If 
true, p9 = 1 the first element is selected. If false p9 = the GOTO is ignored. If p9 is 
omitted, list element 1 is selected; if p9 is a negative value or if the comma is used but p9 
is blank, the GOTO is ignored. If the value of p9 exceeds the number of list elements, the 
last list element is selected. 
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list 14 One or more elements indicating a forward numeric label to which the GOTO could skip. Each [ 

hst element must evaluate to an integer constant value with no forward references. | 



Examples 

The following^ examples contain directives described later in this section 
1. 



A 


ECU 


1 


B 


EOU 


2 




GOTO^B.GT.A+A 


2 




GEN 


A 



GEN 



B 



In this example pi is an expression the result of which is false; therefore, the next statement assembled 
after the GOTO is: 



GErj 



A 



In the following example the source for (a) and (b) was identical. However in (b) the statement "A 
RDEF 1" was not assembled. 

a) 



00 iJuauO&0QOOC9 
00 QuiJuQuuOOtilJl 

kC 



ai OOOQOaiQQQOO F 
01 OOOuO0)00O<fO F 

01 ooQJoajQOOdO f 



b) 



01 000000300000 F 
01 0QOOOO300O't0 F 
01 OOOOOOJOOOSQ F 





X.^PJT 


i,8 




OJTPUT 






ijiHj 




A 


tiOlF 


9 




iOTO, 


19 


A 


i^Otr 


1 


19 


G£^l 


"CO 



COMMA IS DPTIONAL' 



OQ Oil 0.0 00000009 

it3ttFi*0*tO 4l20«*9&i 
20i+F505** «t9*tF'»E^l 



19 



E>10 



IMPJT 

latNT 

R.01F 

GOTO 
G£^l 



EHO 



1,80 



19 
"COMMA IS OPTIONAL' 
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GOTO 



7, A 
5, A 



RDEF 
RDEF 



5+A 
At4 



p9 is missing; therefore, the first Hst element is selected. The next statement assembled after the GOTO 
directive is: 



5, A 



RDEF 



A+4 



The same muneric labels can be re-used provided they are not within the range of a single GOTO 
operation. 



c 

D 
B 
A 


EQU 
EQU 
EQU 
EQU 
GOTO, A. GT.B+D 


2 
1 
2 
6 
2 


1 


GEN 


1 


2 


GEN 


2 




GOTO,C. GT.D 


2 


1 


GEN 


1 


2 


GEN 


2 


results in: 
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RPT AND GOTO PROCESSING 

In functions and procedures, RPT and GOTO directives are processed at call time rather than at definition 
time. 

RPT and GOTO ranges must be in the same level as the RPT and GOTO directives. 

If a RPT directive is within the range of another RPT directive, the range of the inner RPT must be totally 
within the ranee of the outer RPT. 
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If GOTO directives are within the range of RPT, the GOTO can branch outside the range of the RPT. In this 
case, the RPT is terminated, but the repeat symbol maintains its current value for later use. 

An RPT directive must not be the last statement of an RPT range. 



SUBPROGRAM LINKING 

Subprograms are linked through the directive entry (ENTRY) and external data and code (EXTD and EXTC). 
The user can reference, with a program, an address identifier defined in another program. 

Since the programs might be assembled at different times, the address values of these symbols cannot be 
known at assembly time; therefore, certain symbols are declared as entry or external at assembly time. This 
declaration is noted by the assembler and placed in the object code. At load time, the loader must interpret 
entries and externals. 



ENTRY 

An entry is a symbol (address identifier) defined in the program which declares the symbol to be an entry 
point. It also can be referenced as an extemal from another program. An address identifier or variable 
identifier assigned a value with the EQU directive is defined as an entry through the ENTRY directive. This | 
symbol is truncated to 8 characters. 

numeric-label ENTRY list4 *comments 

hst4 One or more address identifiers or variable identifiers (defined by EQU directives) that are 

made available outside the subprogram and defined at the program level. This list can contain 
forward references. 

This directive cannot be used in the universal area (level 1). 



Example 



QST IDEriT 

erJTRY SQRT "DECLARED AS ENTRY 



SQRT EX tti|l''64,2 -'THIS IS ENTRY POINT FOR SQRT 



END 
FINIS 

When a symbol is declared to be an entry, the symbol must appear in the label field of some statement 
within the program. The EX instruction in this example is a machine instruction, described in appendix C. 
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EXTERNALS 

An external is a symbol (address identifier) referenced in a program which declares the symbol external, but 
which is defined (given an address via ENTRY directive) in a separate program. The loader links all externals 
and entries; after all routines are loaded, the loader places the virtual address of the symbol declared as an 
entry into every occurrence of that symbol provided in other subprograms declaring it as an external. The 
assembler provides two external directives: 



EXTD Declares data address identifiers not defined within the subprogram in which they are 
referenced, but defined in a data memory section of some other subprogram. 

EXTC Performs the same function as the EXTD directive except the external reference must be 

defined in the code memory section of some other subprogram. 

The format descriptions for the EXTD and EXTC directives are similar; the general format for both is shown 
below, and exceptions are noted. The braces | | specify that either of the enclosed can be selected. 



numeric-label,hst6 



EXTD 
EXTC 



,p32 list25 *comments 



Ust6 



p32 
(EXTD) 



Optional list consisting of one or more symbols separated by commas. Each symbol becomes 
an address identifier for the first full word generated by the directive. If data generation is 
not indicated, the assembler ignores these symbols and warning messages appear on the listing. 

Optional integer constant, or an expression or variable which evaluates to an integer constant. 
If pi evaluates to integer constant zero or blank (null), a full word (aligned to a full word 
boundary) is generated for each symbol in Hst25. After loading, this word contains the address 
of a designated data entry point. If p32 evaluates to any other value, no data is generated, 
and any symbols in list6 are ignored. The length field is not altered by the loader and may 
be preset during assembly (see FORM). 



le 






DESC 


FORM 
EXTD, 1 


16, its 
A 



"NO WORD GENERATED 



B 



DESC 



12,A 



p32 Integer constant or expression or variable that evaluates to integer constant zero or blank (null), 

(EXTC) two full words (aligned to full word boundaries) are generated for each symbol in list25, after 
loading, these words will contain addresses of the designated code entry point (first word) and 
its associated data area (second word). If other than zero or blank (null) no data is generated 
and symbols are ignored. 

Iist25 One or more symbols external to the program, separated by commas, and v/hich are truncated 

to 8 characters. 

EXTD and EXTC directives must not appear in a code memory section. For referencing external code or data 
address identifiers, only two operators are permitted + and -. 
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Example 

EXTD: 



./^ 



no data generation 



EXTD^l^A 



GEN CA+6^"5) 

^ legal reference since operation is addition 



EXTC: 



Tilt EXTC and ENTRY directives permit reference of an address identifier defined in another sub- 
program. (Machine instructions used in this example, EX and BSAVE, are described in appendix C.) 

"SUBPROGRAM 1 

R_63 RDEF #63-64 "S/R ADDRESS LOADED 

RTN RDEF #1A"64 -RETURN REGISTER 

DATA RDEF #1E"6'+ "DATA BASE (SUPPLIED BY LOADER) 



I DENT 



A EXTC 
MSEC 
LOD 
BSAVE 
END 


SQRT 
2 

DATA,R_63 
RTN,R_63 


"SUBPROGRAM 2 
ABC IDENT 
ENTRY 
MSEC 
SQRT EX 


SQRT 
2 



^DECLARES SQRT EXTERNAL 
«CODE MSEC ADDRESS OF SQRT 



"DECLARES SQRT AN ENTRY 



BSAVE 
END 



^RETURN "RETURN TO CALLER 



FINIS 



A EXTC ,B,C,D,t 



Designates symbols B, C, D and E as external code address identifiers. Two full words are generated for 
each external symbol. A is defined as an address identifier pointing to the first full word generated. 
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SYMBOL AND SET DEFINITION, AND REFERENCING 

Sets are normally defined through the use of the SET directive; however, they can be defined by the follow- 
ing statements and directives: 



ENDP 


Return a subset for a fi 


EXITP 




NAME 




Procedure Call 


Can define up to 4 sets 


Function Call 


Can define up to 2 sets 



SET 

The SET directive assigns the label field symbol as the set name for a list of expressions, set names, set ele- 
ment references, or subsets. (Set element references and subsets are discussed later in this section.) 

numeric-lab el ,list2 3 SET list24 *comment 

Hst23 One or more variable identifiers expressions, set element references or set names separated by 

commas. The elements of this list are the set names for list24. If the list23 set name was defined 
previously by a SET or RDEF directive, the name is redefined as a new set list. 

Hst24 Set elements separated by commas. It can include expressions, set names symbols, set element 

references, or subsets. Elements of list24 can include repetition and positional operators. Repe- 
tition operators can be nested; positional operators cannot. A positional operator can appear 
within a repetition if its value is 1 . List24 elements assume the value defined during SET direc- 
tive processing. To change the value of an element, the user must redefine the set Hst element. 
Also, the number of list24 elements can be extended by redefining the entire set Hst with a 
SET directive. 

I An empty list24 element is specified by two adjacent commas. Zero is the impHed value and 

the mode of the element is null. 

I Symbols in list24 become copies of the original symbols. If a symbol name in list24 is redefined or changed 
in a statement following the set statement, the set list element is not changed. 



ub uuUUUUutJJuuA 



Ul jGiiuu v} J 3 y OQli F QuQQJuuU UUuUQtiuA 
ul u uUuUil} U Odu F JuuuuQaU Ouuuyiim 

uT y U y y u yJyyQ^y F y u u y j y y~y y y y y D U u 





liiPjl 


1,80 




jjT^jr 






LJc^l 


^ 


A 


^Jc- 


10 


d 


^J£- 


5 


u 


^£r 


k,B 


A 


riJi" 


Z\i 




\j^vi • 


^u^,Z 




Gti i 


irM(ArT(cCi>,in 


E 


SdT i, 


Cl,C2,C3>>^ 




Gd,>l £ 


CO """ " ' 
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Examples 

The following examples illustrate the rules for positional operators and null elements in set definition. 

POSITIONAL OPERATOR 

When a positional operator (:) is used, the value to the left of the operator specifies the set position assigned 
to the value to the right of the operator. All previous set positions between that occupied by the previously 
specified set element and the value to the left of the positional operator are null positions. 

^ — list-1 ^ — mnemonic ^ — list-2 



A SET 5, 4:2, 3 

define^ a sef element \ — indicates the 4th element is the value 2 

5, [null] , [null] ,2,3 

This is equivalent to: 

A SET 5. ^^2^3 

where A [2] and A [3] are nulls. 

A SET 1^3: [4,3:51,2 

defines a set: 

1, [null] , [4, [null] ,5] ,2 

where: A [1] = 1 

A [2] = null 

I A [3,1] = 4 \ 

A [3] = I A [3,2] = null > 

^ A [3,3] = 5 J 
A [4] =2 

Positional operators must appear in ascending order, left to right. 

A SET 3:2,1=6 is illegal, and illegal positional operator is ignored by the 

assembler. 
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NULL ELEMENTS 

A null element can be specified by use of a positional operator or by double commas: 

1. (specifies null)- 



same as: 



7 

A SET ,2/3 

A SET 2:2,4:3 



A [1], A [3] and A [5] are nulls and return a value of zero. The integers in [ ] specify the positional 
location of the elements referenced. Referencing elements A [2] and A [4] returns the values 2 and 3, 
respectively. Since A [5] is outside of the set a null is returned. 



IMPJT 1,»0 
OJTPJT 

B SET i,Z,Z,kt5 

01 OQQOOJiJ aOOO F UOQuQOdO OOQOaO ul GEN Btl3>6£2] ,dl3] ,3 M , b[53,bE63» bLIu] 

01 uoouuGiaaoi»o i^ uoooauou ouuuuuiTZ 

01 OOOOOOIGOQBO F OOOOOOuO QuOOOuiJJ 
01 000000130030 F OOOOOOuO OOOOOOQit 

01 oaooooiooiao f oouooouo uoooooos 

01 OOOOOOJ30H»0 F 00000000 OOOaOoOOl r.r^i J Rnnl arp null valiiP? 

01 ooooooiouiao f oqooqouu ooauOG Co/ ^l^J ^""^ B[1UJ ar e null value s 

-- - ^^^ 



REPETITION 

To specify value, set name, etc., in succeeding positions within a set list, the user can specify a repetition 
factor for that element. Repetition is requested by an integer or an expression or variable which evaluates to 

an integer constant (specifying the number of times the element must be repeated) followed by the elements 
in parentheses. 

A SET 5,3C2)^2 

is equivalent to: 

A SET 5,2^2^2^2 

Repetition can also be specified for subelements of an element in a set list. 

A SET 5,20,4),2 

is equivalent to: 

A SET 5,3,4,3,4,2 

A QFT 9rfl9l7"^ 
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[1,2] are subelements of set A. 

REFERENCING SETS 

A set reference can appear in label, command, or operand field lists and must not be a forward reference. 

A set reference consists of a set name and the position of the desired set element enclosed in brackets [ ] . 
Should the user specify 

D SET A^B^C 

and desire the value "B", he would reference the set as follows: 

GEN D[2] 

because B is the second element of set D. 

Should the user desire the entire set then the set reference would be written as: 

GEN .ELM.D which returns A 

B 
C 

A reference such as: 

GEN D 

results in an error message 

XX ILLEGAL DATA IN FORM/GEN IN OPERAND FIELD 

ELEMENT AND SUB-ELEMENT REFERENCING 

A set element and sub-element is referenced by writing the set name with following expressions that specify 
the ordinal location of the element or sub-element. A set element reference can be written in the field list 
portion of the label, command, or operand of any statement. 

The elements of a set can consist of many sub-elements; which are specified as an elem.ent by enclosing 
them in brackets [ ] . e.g. 

B SET 5, [6,7] 
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The name of the particular set followed by expressions locate the desired elements or sub-elements. 

set-name [expressions] 

Sub-elements [6,7] comprise the second element of set B. These sub-elements can be referenced as follows: 

GEN .ELM. B [2] returns 6,7 - to obtain 6 and 7 .ELM. must preceed the element reference 

GEN B [2,1] returns 6 - set B, element 2, sub-element 1 

GEN B [2,2] returns 7 - set B, element 2, sub-element 2 

The following would generate an error message, "ILLEGAL USE OF .ELM. OPERATOR IN OPERAND FIELD 
GEN .ELM. B 

ASSIGNMENT 

Values are assigned to a symbol by the Redefine (RDEF) and Equivalent (EQU) directives. 

RDEF 

Assigns the value and attributes of an operand field expression to the symbols specified in the label field. A 
symbol initially defined by this directive may be redefined using the same directive. Symbols defined by RDEF 
may not be forward referenced. 

numeric-label,Hst5 RDEF p3 *comments 

lists One or more variable identifiers, set element references, or set names separated by commas, 
that assume the value and attributes of p3. 

p3 Any expression; p3 cannot be a set name. p3 cannot contain a forward reference to a statement 

that contains a forward reference. p3 cannot be a forward reference to a redefinable quantity 
(another RDEF or SET element). 

A RDEF B 



RDEF C \ Not Permitted 
I 



I 

C RDEF 1 



If p3 contains a forward reference, the list symbol cannot be used in a statement that could 
affect the location counter. p3 cannot reference symbols declared external in EXTC or EXTD 

directives, e.g.: 



"RES IS DESCRIBED UNDER 
"LOCATION CONTROL 
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A 


RDEF 


B 


B 


RDEF 


1 




RES 


#A"&^"6^ 



Examples 






A 


RDEF 


15 


B 


RDEF 


@ 


C 


RDEF 


A+3 


C 


RDEF 


C+2 


p 


SET 


3.5 


E[2] 


RDEF 


6 


E 


RDEF 


2 



A has integer constant value of 15. 

B has address identifier value equal to the current 
location counter. 

C has integer constant value 18. 

C has integer constant value 20. 



Redefines element 2 with a value of 6. 
Redefines set E to a variable identifier. 



EQU 

EQLT assigns the value and attributes of an operand field constants, expression or variable to the symbols 
specified in the label field. A symbol defined by EQU cannot be redefined. Symbols defined by EQU may not 
be forward referenced. 

numeric-label,list5 EQU p3 *comments 

lists One or more variable identifiers or single set element references separated by commas that 

take on the value and attributes of p3. List elements can be defined as entry points; how- 
ever, in this directive, they must be defined as hexadecimal constants. If not a hexidecimal 
constant a mode error occurs. 

List elements cannot be redefined. 



p3 Any expression; p3 cannot be a set name or a redefinable quantity that is not yet defined 

and cannot contain a forward reference to a statement that contains a forward reference. 
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EQU 

I / 

Not Permitted 



1 

B 


EQU 


C 
1 


1 
C 


EQU 


1 


A 


EQU 


B 


B 


EQU 


1 



Permitted (except in universal area) 



I If p3 contains a forward reference, the list symbol cannot be used in a statement that affects 
location counting. 

I p3 can contain references to symbols declared external with the EXTC or EXTD directives. 

Examples 

1. 

C EQU 1 

D EQU 2 

A EQU D. LT. CC + 2) 

B ECU A+E "EQUIVALENT TO B EQU 4 

E EQU 3 

2. 

^ ^^Vrr ^o Error: A-DOUBLY DEFINED 

A Kutr -'• ^ 



i -^ Error: ILLEGAL OPERAND OR PARAMETER 



A 
A 


SET 
ECU 


2.5 J 

10 


4. 






A 


SET 
GEN 


2,5 

.ELM. A 


A 


RDEF 
GEN 


10 
A 



"GENERATES 2 AND 5 
"GENERATES 10 
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DATA GENERATION 

Data generating directives define data format and generate information to be placed in the object deck. 



FORM 

Defines a data generating format that specifies alignment and field size in bits. 

numeric-label,Ust7 F0RM,p4 listS *comments 

list? One or more symbols separated by commas. Each symbol becomes a name used to reference 

the form. 

p4 Variable or expression resulting in an integer constant representing the bit alignment for the 

current location counter when the form is referenced. Forward references are not permitted. 
If p4 is not included, a value of 1 is assumed. Any value is acceptable; however, 1, 8, 16, 
32, 64, 128, and 256, and 512 are recommended. 

hstS List of expressions, variables or integer constants, separated by commas. The value specifies 

the field size of the form in bits. The value must evaluate to or be an integer constant with 
no forward references. The fields specified in Ust8 can be repeated by using the repetition 
operator; repetition can be nested. Null elements are not permitted. These values specify field 
size in bits and can be any value. 

Defining a symbol to be a form name does not restrict the use of that symbol as an address or variable 
identifier. 



1 field, 24 bits long, aligned to a bit boundary 

1 field 48 bits aligned to a full word boundary 

4 fields, each 8 bits aligned to a byte boundary 

Defines I as a set consisfing of [8,8,48] . 

3 fields, aUgned to a 64-bit boundary. The form 
has two names. 

8 fields, aligned to a ^^-word boundary 



Example 






WORD 


FORM 


2H 


W0RD2 


FORM^64 


48 


2^ CHARS 


FORMES 


S^S^^^S 


I 


SET 


8^8^48 


AA, INST 


FORH^64 


,ELM,I 



A FORM, 32 4C8,16) 

is equivalent to: 

A FORM, 32 8,16,8,16,8,16^8,16 

B FORM, 64-512 1,15,48 

(virtual page size) 
DESCRIPTOR FORM, 64 16,48 



3 fields, aligned to a 512-word page boundary 



length (0-15) and address (1648) of vector 
descriptor 
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FORM REFERENCING 

A form reference generates data starting at the first bit after alignment is performed. The data is stored in the 
memory section containing the reference. Form references must not appear in a function or a procedure called 
via a function call. 

numeric-label ,list9 form-name list 10 *comments 

list9 Address identifiers, separated by commas; they assume the value of the current location 

counter after alignment is performed. 

form-name Name of the form to be referenced. 

list 10 List of expressions, separated by commas. The value of eacK expression is placed into the 

field of the form. The position of the expression in list 10 specifies the field destination for 
the value. The positional operator and repetition operator can be used with the expressions 
in list 10. If list 10 is longer than the number of fields in the form, the form fields are 
repeated, but alignment is not repeated. 



Examples 



-Word Boundary 



WORD F0RM^G4 16,48-*— , 
A GErj 24' 1 



r 

i,aJ>-! 



WORD 

V 

^•Call 

Generates a full word aligned to a word boundary with the value 1, right justified and zero-filled, in bits 
through 15; and the address of A right justified and zero-filled, in bits 16 through 63. 

LABEL V;ORD "AB",@ 

Generates a full word with characters "AB" in bits through 1 5 and the value of the current location 
counter (requested by use of (" ) after alignment. The value (« is right justified, zero-filled in bits 16 
through 63. 

EXTD^l A "DEFINE A AS EXTERNAL WITHOUT 

GErJERATING DATA 

D WORD 3, A "SET BITS 0-15 WITH 3 AND LOADER 

WILL SUPPLY EXTERNAL DATA ADDRESS 

Oi i-\ LVi BiiS lb tO b..>i. 
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CHAR FORM, 8 
Bl RDEF 



^ 



CHAR 2C"A",B1),6: 1} 



Generates a byte string aligned to a byte boundary. The first byte contains "A", the second, "B", the 
third "A", and the fourth "B". Contents of the fifth byte is zero, and the sixth contains the value 1 
riglit justified, zero-filled. 

CHAR FORMES 8 

I SET 2C"A",B1),5: 1 

CHAR ,EUM.I 



This example is equivalent to the immediately preceding example. 



GEN 

Generates data starting at the next aligned bit; data is stored in the memory section containing the directive. 
The GEN directive must not appear in a function or a procedure called by a function call or in the universal 
area of a program. 

numeric-lab el ,list 12 GEN,p4,p8 listl3 *comments 

listl2 Address identifiers, separated by commas. They assume value of the current location counter 

after alignment is performed. 

p4 Must be an integer constant or a variable or expression which evaluates to an integer constant 

with no forward references; specifies alignment in the current location counter. Alignment is 
performed prior to data generation and applies only to the first expression in hstl3, p4 must 
be greater than zero and without forward reference. The default value is 1. 

p8 Integer constant or a variable or expression which evaluates to an integer constant specifying 

the number of bits to be reserved for each expression in listlS. It must be greater than zero 
and without forward reference. If p8 is not included, the mode and value size of each expres- 
sion listlS specifies the number of bits to be reserved. 

Ustl3 List of expressions, separated by commas. The value of each expression is the data generated. 

The repetition operator can be used with expression in HstlS. 

The rules for data generation specified in appendix A (see CONSTANTS) are applicable to the GEN directive. 
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Examples 

A GEN, 64 -5 

Generates a full word aligned to a full word boundary. Bits through 63 contain the value -5 with sign 
extended. 

B GEN, ,48 A 

Generates 48 bits with bit alignment (specified by „). Bits through 47 contain the address of A. 

C RDEF "ABCDE" 

GEN, 32 5,C,P"32" 



Generates a full word aligned to a half-word boundary with the value 5 in bits through 63; also gen- 
erates a 5-character byte string containing "ABCDE" and a 2-character byte string containing the signed 
packed constant P"32". 

GEN D 



Generates a full word with bit alignment (default size specification). Bits through 15 contain zero; bits 
16 through 63 contain the address of D. 

2,D GEll B"10010" 



Generates (5 bits) 10010 aHgned to a bit boundary. 
GEN, 32, 64-10 r'-2" 



Generates 10 full words aligned to a half-word boundary; they contain -2 in binary integer form with sign 
extension. 



GEN, 54, 128 10CB"10") 



Generates ten 128-bil fields with the first field aligned to a full word boundary. Bit 126 of each field 
will be set. 
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ADDRESS AND LOCATION CONTROL 

The code and data sections of an assembler subprogram are assigned to specific virtual memory areas. Code or data 
can occur in any memory section; however, externals are not allowed in MSEC code and entry points are illegal in a 
common MSEC. Code and data are assigned explicitly through the MSEC directive. Absence of an MSEC directive 
implicitly assigns code and data to the default data memory section IMEM. (IMEM is a reserved symbol assigned to 
a default MSEC.) 

Each memory section has a unique relocatable location counter. The loader (not the programmer) determines 
the memory section where code or data is to be stored. Each location has the same relocation as the memory 
control that defined the location counter. Location counters are bit incremented; all memory addresses, therefore, 
are bit addresses. 

An ordinal number is reserved for each location counter (each MSEC) sequentially in the order of memory 
control section definition. The STAR assembler permits up to 255 control sections (ordinals) in 
any combination. Ordinal 1 is reserved for the default IMEM, created when an IDENT statement is encountered. 
Any subprogram can use one or more memory sections; however, only one location counter can be active at 
any one time. The current location counter is designated by the last MSEC, ORG, EORG directive, or the 
default MSEC. 

All address identifiers derive their value from the currently active counter and take on the same relocation as 
the current counter. The value of the current location counter can be altered by the following statements which 
can also define address identifiers: 

GEN directive reference 
RES directive reference 
ORG directive reference 
Procedure reference 
Form directive reference 
Machine Instructions 

All data generated is stored in the currently active memory section. The following statements cause data 
generation: 

GEN directive reference 

FORM directive reference 

Procedure reference (unless called from a function) 

Machine instructions 

The assembler interprets a reference to a memory control section name as a reference to the current value of 
its location counter. Use of @ (commercial "at") returns the value of the currently active location counter. 
The following example illustrates expUcit specification of a memory section on a typical assembler printout. 
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IDENT 


J2 


u Ci J .1 1 D Q .T 










MSEC 2 
ENT'^Y START 








K 


JjIjuOCuuIC -0 


A 


EQU ♦'♦r»6'» 








u C 


J J JoCCCClC itO 


3 


EQU ♦'♦1»6'* 








;c 


J-CGGU^aiC 30 
3 C L J C L-i a 3 C 1 <♦ 


C 
N 


EQU imz*bk 
EQU 2: 








(jC 


C'::joojC37tfO 


PSP 


EQU #10»b'* 








Ot 


3;. JuOiJ iOSSttO 


VITAL 


EQU *l5*bk 








uC 


0-0 000 3 3 0660 


RTRN 


EQU #lfl»6<t 


32 


O00D00300OO0 


f 


BEi^C 


3 3C[, 00 3 30 01 


COMMENCE 


EX fl,l 


32 


OQOOuOOuOOUC 


f 


73<tC 


3i»l 




RTOR a, 6 


D2 


uOOQ30nO0O6'- 


H 


2att2031't 




ELEN C,N 


02 


000300000080 


F 


DFjC 


03'*0 OO'tlOC'tZ 




INTERVAL A, 



\ 




THES£ REGISTERS CONTAIN 

SOURC: ELEMENTS 

CONTAINS RESULT VECTOR DESCRIPTOR 

LENGTH OF RESULT VECTOR "C" 

« 

••» £>(TRY SEQ SEE APPENDIX K 



VALUE 1 SOURCE 

TRANS 1ITS VALUE 1 TO B SOURCE 

VALUE 20 ENTERED INTO LENGTH PORTION OF C DESC. 
A,g,C 'CREUES VECTOR C 



Specifies 


location 


Specifies boundary, 


MSEC 


counter 


(Full, Half, Character, 


with an 


(address 


Bit) 


ordinal 


counter) 




of 2 







DEFAULT MSEC 

The default MSEC is aligned to a double-word boundary and identified as IMEM. IMEM is classed as a data 
MSEC with an ordinal of 01 and cannot include monitor mode instructions. 

Note: MSECs following the first MSEC 1 will not align to a boundary larger than double word even when 
specifically requested. 

Example INPUT 

OUTPUT 
IDENT 
MSEC 1 



MSEC 1 

GEN,64*512 10 
t 
The last instruction tries to align 
to a page boundary, but it doesn't work 
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MSEC 

This memory section directive defines a control section and makes it current. The MSEC directive can be used 
only in subprogram areas and in procedures not called by functions. 

numeric-lab el ,list 17 MSEC pl8,pl9 *comments 

listl7 Optional address identifier used to reference the memory section. The current value of the 

memory counter is returned upon reference. The address identifier on a MSEC 3 will become 
the name of the common block. 

pl8 Optional integer constant or variable or expression which evaluates to integer constant 1, 2, 

or 3 specifying the kind of control section. 

1 Data MSEC 

2 Code MSEC 

3 Common data MSEC 

Default is 1. 

pl9 Optional integer constant or variable or expression which evaluates to an integer constant 

indicating whether monitor instructions are permitted in the memory section. 

1 Monitor instructions permitted 
=5^1 Monitor instructions not permitted 

Default is monitor instructions not permitted. 

Multiple code memory sections within the same program area are concatenated by ascending ordinal number 
to form one memory section. Each memory section is aligned on a word boundary after concatention. The 
same is true for multiple data memory sections. 

The use of multiple common memory sections within one subprogram area requires a unique address identifier 
list 17 for each common MSEC. 

Examples 

1- A MSEC 

Defines A as the name of a data memory section (default for pl8 is data). Monitor instructions are not 
permitted (default for pi 9). 

2. A MSEC 1 " DATA MSEC 

B MSEC 2^1 " CODE MSEC WITH MOniTOR INSTRUCTIONS 
C MSEC 3 " COMMON MSEC 

D MSEC 4 " WARNING MESSAGE - THERE IS NO i+ OPTION TO P18--S 

DATA MSEC IS DEFINED VIA DEFAULT 
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3. The following example demonstrates a means of communicating with MSEC COMMON. 



DATA_BASE 

R_C_BASE 

01 

Tl 

T2 



C BASE 



START 



INPUT 


1,80 








OUTPUT 










EQU 


#lE"6i+ 








EQU 


#20-64 








EQU 


#21"6it 








EQU 


#22-64 








EQU 


#23-64 








I DENT 










MSEC 


1 






"DATA MSEC 


EXTD 


COMMON 






"LOADER WILL FILL WITH 
ADDRESS OF COMMON BLK 


MSEC 


2 






"CODE MSEC 


ENTRY 


START 








LOD 


DATA_BASE,R. 


S. 


BASE 


LOD 


R C BASE, 


Tl 




"T1=FIRST WORD OF COMMON 


ES 


Cl,l 








LOD 


[R C BASE 


.CI], 


T2 


"T2=SEC0ND 


ADDX 


T1,T2,T1 








STO 


R_C_BASE, 


Tl 






END 











(OTHER SUBPROGRAMS) 



COMMON 



I DENT 




MSEC 


3 


GEN 


1 


GEN 


2 


END 




FINIS 





I Loader places address of program START'S data base in Reg #1E; i.e., points to C_BASE. Loader places in 
memor}' location C_BASE the address of the common block COMMON. 
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RES 

Aligns the current location counter and adds to it the value of the expression (bit value) in the operand field. 
This directive can be used in the subprogram area and in procedures not called by functions. 

numeric-label,listl7 RES,p4 p25 *comments 

listl7 Optional list of address identifiers (separated by commas) their values are the values of the 

current location counter after alignment. 

p4 Optional integer constant or variable or expression which evaluates to an integer constant 

specifying alignment in bits. Default is 1 (bit boundary). Any value may be selected; however, 
1, 8, 16, 32, 64, 128, 512 are recommended. 

p25 Optional expression with an integer constant value specifying the bit value to be added to the 

current location counter after alignment. Default is 0. 

Examples 

A RES, 32 32-512 

Reserves 512 half-words aligned to a half-word boundary. 

L EOU 100 

BYTE RES, 8 8-L 



Reserve 100 bytes aUgned to a byte boundary. 



ORG 

Sets the location counter to a specific value; the memory section associated with the location counter then 
becomes active. The ORG directive can appear in a subprogram area or in procedures not called through 
functions. 

numeric-labeUist26 ORG p21 *comments 

list26 Optional list of address identifiers, separated by a comma. Each address identifier in the Hst 

assumes the value of the current location counter after the ORG is completely processed. 

p21 Expression or variable which evaluates to an integer constant or integer constant value of an 

associated memory section ordinal. The bit value, p21, is the value that becomes the location 
counter of the memory section implied by the ordinal number. The current memory section 
becomes associated with the ordinal number. 

If p21 has no ordinal number, the current location counter is set to the value of p21. 
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Examples 

1. A MSEC 

B MSEC 

C ORG A+64 

Sets the location counter of MSEC A to that of its current value plus one full word. 



2. 



A 
B 
C 



MSEC 
GEN^ 64 
MSEC 
ORG 



5 
B+64 



Sets the current location counter of memory section A to that of relocatable address B plus one full 
word. 



EORG 

Sets the current memory section to the value of the memory section specified prior to the last MSEC or ORG 
directive. This directive can be used in a subprogram area or a procedure not called through a function. 

numeric-label EORG *comments 



Examples 



1. 


A 


MSEC 




2. 


B 


MSEC 




3. 
4. 




ORG 
EORG 


A 



In this example, the location counter is first set to the address of data memory section "A". In (2) a second 
data memory section is specified and the location counter is updated accordingly. The ORG directive sets the 
current memory section to A and updates the location counter to the address of MSEC "A". In (4) the 
current memory section is set to the value specified prior to the ORG directive; therefore, "B" is the current 
memory section. 



A MSEC 
B MSEC 

ORG A 

ORG (a+512''64 

EORG 



*specifies address of memory section A, 
*specifies current address plus 1 full page 



Sets B as the current memory section. 



432 
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MSEC 
MSEC 



Sets A as the current memory section. 



ATTRIBUTE CONTROL 

Extrinsic attributes are assigned, referenced, and changed by the user; attribute numbers may vary from 8 to 127. | 
(Intrinsic attributes and the ATT function are described in section 5.) 

An extrinsic attribute is assigned and changed with the RATT directive. 



RATT 

numeric-label,list21 RATT Hst22 *comments 

hst21 One or more address identifiers, variable identifiers, set element references and/or set names 

v^hose attributes are to be changed. 

Hst22 A list of elements, separated by commas; each has the form pl:p2. 

pi Is the attribute number; the value of pi must be an integer constant, an expression 

or variable which evaluates to an integer constant greater than or equal to 8 and less 
than 128. An identifier can have up to 120 extrinsic attributes. Within one RATT 
directive, each pi entry must be unique. See example 3. Also, pi values must be in 
ascending order. 

p2 Is the value of the extrinsic attribute. The value of p2 must evaluate to a constant 

with no forward references. 

The RATT directive cannot be used with the intrinsic attributes (1-7). 

Examples 

1. 



A 



RATT 



8:5,9:#10 



then: 



ATTCA,8) IS 5 
ATTCA,9) IS 16 



See section 5 for a description of the ATT directive. 
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2- INPUT 1,30 

OUTPUT 

lOENT 
3 SET 5,"ABC",6,"0EF" 
GO OQOOOODQOOOl C EQU 1 

0[2] RATT 9lC,10!B[l] 

END 

The 9th attribute of B[2] is 1; the 10th attribute of B[2] is 5. 

3- INPUT 1,80 

OUTPUT 

lOENT 
3 SET 5,"ABC",6,"DEF" 
OGQQOOOOOOOOOl C EQU 1 

B[2] RATT 9:C,9:B[1] 
»»»* IMPROPER USE OF POSITIONAL OPEPATOR, (!) IN OPERAND FIELD 

END 

REFERENCING ATTRIBUTES 

Attributes are referenced through the ATT function described in section 5. 

PROCEDURES 

A procedure (PROC) is an assembly time subroutine that normally, can be used to generate code. This type of 
procedure is called in-line; and when it is called, it returns generated code to the location from which it was 
called. Procedures can be defined in the universal or subprogram areas. Forward references are permitted only 
I in those PROC's called from the subprogram area or from a lower level. When a procedure is called, all identifier 
names defined in the procedure are assigned to level 3 or greater depending on the nest level of the call. At 
call time, if a referenced symbol is not found in a procedure, the preceding levels are searched. Each time a 
procedure is called and code is returned, the object code increases proportionally because only one copy of the 
code will exist. 

PROC's should be written in a generalized form which allows the internal definition to produce concise code. 

WRITING A PROCEDURE 

In writing a PROC, the programmer performs the following steps: 

Defines what is to be accomplished. 

Writes a definition such that a change to the PROC will include a change to others affecting it. 

A procedure definition starts with a PROC directive and ends with an ENDP directive. The statements and 
directives within these limits are referred to as the statement body. Unless explicitly stated in the description 
of a directive, the directive can be used in the procedure definition in the subprogram area. 
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Examole 



PROr 

Definition PI PR0C,P2 P3 



Statement ) aa NAME -'SPECIFIES AN ENTRY POINT TO THE PROC 

Body 



ENDP 

The following applies to all Procedures. 

• Procedures can be defined in the universal area at level 1 or in the subprogram area at level 2. When 
defined in the universal area, the PROC can be referenced from any universal or subprogram area that 
follows the definition. 

• Procedure definitions may not be nested. 

• Procedures can be referenced from any level. 

• The definition of a procedure must precede a reference to it. 

• Procedures defined in the subprogram area are lost when the END directive is processed. 

• Procedures called through the use of a function must not contain any statements that could affect 
location counters. 

• Procedures cannot be redefined. 

• Symbols defined within a procedure are local to the procedure in which they are defined: the symbols 
are lost upon exit from the procedure. These symbols can be made available outside the procedure by 
appending a $ to them. On encountering the S, the assembler checks the call level for symbol definition, 
provided the procedure was called previously. 

• Depending on the area from which the original call was made, procedures can define symbols in the 
universal or subprogram area when a $ is appended to the symbol. 

• To reference a symbol in the universal or subprogram area that is also defined in the procedure, append 
a S to the reference. 

• Procedures can reference symbols defined at all lower levels, if the symbol is not also defined at the 
current level. 

• Procedures can contain forward references to symbols defined within the procedure if the procedure is 
called from the subprogram or lower level. 

• Procedures can include more than one NAME directive (entry point). 
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• A name within a PROC can call another name in the same PROC. Also, a name can call itself. 

• Procedures are recursive to 128 levels. 

• If two procedures within a library file have the same name and the name used is a PROC call the 
assembler wUl issue a diagnostic "MULTIPLE DEFINED SYMBOL". 

PROC 

Declares the start of a procedure definition: 

numeric-label,p22 PROC,p23 p5,p6 *comments 

p22 Optional symbol that becomes the set name for the list of numeric labels and symbols that 

appear in the label field of the procedure reference statement. This set name is made available 
to this procedure when the procedure is called. 

p23 Optional symbol that becomes the set name for the list of expressions, set element references, 

and symbols that appear in the command field after the procedure name in a procedure 
reference statement. This set name is made available to this procedure when it is called. 

p5 Optional symbol that becomes the set name for the list of expressions, set element references, 

and symbols that appear in the operand field of the procedure reference statement. This set 
name is made available to this procedure when it is called. 

p6 Optional symbol that becomes the set name for the set list that appears in the operand field 

of the NAME directive. This set name is made available to this procedure when it is called. 



Example 



L_SET 


PROC, C_SET 


SUM 


NAI^E 




GEN 




ENDP 



0_SET, N_SET 

1.2,3 

L SET[1]+C_SET[2]+N_SET [3] +0„SET [l] 



This PROC uses all four sets. 



NAME (procedure; 



Defines a procedure name and the entry point of the procedure. This directive is processed when it is defined; 
statements following the NAME directive are processed when the procedure is called. Any number of NAME 
directives can be used in a procedure definition. 
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This directive, with some variation, is used in a function definition and described in that context under NAME 
(FUNCTION). 

numeric-label,p7 NAME,p33,p20 listl6 *comments | 

p7 A symbol that becomes the procedure name. This symbol is entered in the command field 

of a procedure reference (call). 

p33 Optional integer constant, its bit value is the boundary for alignment of the current location 

counter when the procedure is called. If p33 is missing, no alignment is performed. 

p20 Optional integer constant. If the value of p20 is 1, the symbols in the label field list of the 

procedure reference (call) remain undefined. If p20 is zero, > 1, or blank all symbols in the | 
label field list of the call are defined as address identifiers. The value of each address identi- 
fier equals the value of the current location counter after alignment. 

list 16 An optional list of set elements which must be completely definable when the procedure is I 

defined. Forward references are not permitted, and any symbols in this set list must be de- I 

fined in the universal or subprogram area. The set name for this set list is the p6 symbol | 
defined in the PROC directive. 



Example 



PROC B^A 

ABLE NAME, 6^ 5/'ABCD", P"-25" 

ENDP 



ABLE is the entry point to the procedure. When the procedure is called, the current location counter 
is aligned to a 64-bit boundary. When the procedure is called, the set A consists of the 3 elements: 
5, "ABCD" and P"-25". 

ENDP (PROCEDURE) 

Terminates a procedure at definition and call time. With some variation, it is used to terminate a function 
definition and is described in this context under ENDP (FUNCTION). 

numeric-label ENDP *comments 
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PROCEDURE REFERENCE 

A procedure can be called (referenced) at any level through a procedure reference statement containing the 
procedure entry point name in the command field. EHiring a call, parameters specified in the label, command, 
and operand fields can be passed to the procedure. A PROC must be defined before it can be called, and 
nesting can occur to a depth of 125^q. A procedure referenced through a function cannot contain a statement 
that affects a location counter. A summary of the relationship of the PROC directive, NAME directive, and 
procedure reference is illustrated in figure 4-1. 

numeric-labtUistlS p7,listl9 Hst20 *comments 

list 18 Optional symbols, separated by commas and passed as parameters to the PROC definition 

directive. These symbols are defined as address identifiers, unless the p20 parameter in the 
called name (NAME directive) prohibits definition. 

p7 Procedure entry point name that appeared in the label field of a NAME directive in a pro- 

cedure definition. 

Hstl9 Optional list of set elements passed as parameters to the procedure. 

Ust20 Optional list of set elements passed as parameters to the procedure. 

List 19 and list20 may consist of set names, set elements, subsets, symbols, and expressions. The repetition 
operator and positional operator also can be used in Ustl9 and Ust20. 

A user can insert a STAR instruction mnemonic or a directive name in a PROC call. The assembler checks 
the user-defined table before checking the internal definition table, thereby permitting redefinition of an 
instruction or directive. Once the user redefines an instruction or directive, however, the internal definition in 
the area redefined (universal or subprogram area) cannot be accessed. 

PROCEDURE REFERENCE TERMINATION, EXITP 

This directive terminates a procedure reference before the ENDP directive is encountered. More than one 
EXITP directive is permitted in a procedure or function. With some variation this directive is used to terminate 
a function reference and is described in this context under EXITP (FUNCTION). 

numeric-label EXITP *comments 
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PROCEDURE REFERENCE FUNCTION FLOW 

TTip frkllnu/itia PViirnnlp illuctrqtec hnw iht^ Qccpml-ilpr HpnHlpc ij nrnpprlnrp rpfprpnpp ' 



Procedure Definition 
in Universal Area 



\ CALL 



PROC.CF 


OF,AF 


NAME,A,LFSU 


ARGU 


ENDP 




I DENT 





Procedure Call 

in Subprogram Area 



\ R_l/R_2 CALL^S_1^S_2^S_3 T_4^ T__3, T_2^T_1 



END 



Although the PROC call is defined in the universal area, it is called in the subprogram area and assigned a 
level of 3. 

When the PROC statement is encountered, the assembler scans for a name line and ENDP directives. All other 
statements are checked for syntax errors. 

When a procedure is called, a copy of the label, command, and operand sets in the procedure reference state- 
ment are passed to the PROC definition. 

If the call is made in the universal area, all parameters and procedures must be defined before the call is made; 
since the assembler makes only one pass through the universal area. For a procedure call is in the subprogram 
area, it is not necessary to define all parameters prior to the call because two assembler passes are made 
through this area. 

The sets passed are copies of the originals; therefore, the only method of changing elements in the original set 
is by appending a $ to the label in the label field of the PROC. When the sets are passed, as specified in the 
previous example the following argument results. 



PROC Definition Symbols Associated Call Parameters 

LF R_1,R_2 

CF S_1,S_2,S_3 

OF T_4,T_3,T_2,T_1 

In addition to the three sets that can be passed at call time, the argument set exists as part of the operand 
field on the NAME line. Since a PROC definition can have more than one NAME line an argument set can 
exist for each. At any one time, the only applicable argument set is that associated with the called NAME 
directive. 
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Examples 

When the PROC is entered it is possible to generate code/data. For additional examples see appendix I. 

The following examples illustrate a PROC used to redefine a symbol in the command field. 



PROC 

DEFINITION 

1 



CALL 





PROC, 


CF 




OF 


NO GEN 


NAME 








SYMCATTCCF[1],1),1) 


RDEF 
ENDP 






0F[1] 


A_X 


RDEF 






#9B 




NO_GEN,A_ 


_X 


"ONE" 



At call time the value #9B is passed to CF and "ONE" is passed to OF. Since CF and OF represent a 
set, any reference to the set, even though each contains only one element, must be written [1]. The 
brackets specify set reference, and 1 specifies the first element. 

PROC.CF OF 

PROC I NO_GEN NAME 

DEFINITION ) A_SET$ SET 25:0 

2 ) I RPT.ATTCCF [1] ,7) 100 

100,A_SET[I] RDEF OF[I] 

ENDP 

CALL (B_SET SET 6 /'BI T" , # 9, X" ^", 2 : 

{C_SET SET 1.2,3 

) NO_GEN,C_SET B_SET 
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Of the three possible sets that can be passed to the PROC definition, two are passed. 

The command and operand fields have only one set element. The defined C_SET has three elements and 
the B SET has 20. Each C_SET elem.ent is a 40-bit integer constant. The defined B_SET is comprised of: 

Element Attribute 

6 48-bit integer constant 

"BIX" Character string 

#9 48-bit hexadecimal constant 

X"4" Hexadecimal string constant 
15 null elements 

The 20th element is a 48-bit integer constant of 0. 

The A SET is defined to have 25 elements: the first 24 are null elements; the 25th element is a 
48-bit integer constant of 0. 

Tliis set name is also available at the call level after the PROC has been exited. 

Since the NAME Une has no parameters, no aUgnment is required and label field symbols are defined. 

The repeat directive is set inifially to 3. The seventh attribute of CF [1] returns the number of elements 
passed to the command field set. This value specifies the number of iterations of the repeat loop. The 
last statement in the repeat loop is at label 100. 

The first occurrence through the loop redefines the value of the first element of the A_SET to be equal to 
the first element of the B_SET. 

The second and third elements of the A_SET are redefined during the second and third iterafions of the 
RPT loop. 
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The following are examples of procedures used for data generation: 



A 



JOE 



AAl 



PROC.B- 



NAME ^6 it 

GEN 
GEN 
GEN 

IDENT 



r-^C^D 



/ 



A[l] 
B[l] 
C[2]+D[l] ,C [1] 



JOE, 3 — IL— "AA1_1",5 



This procedure call to JOE is the same as writing: 



AAl 



RES, 54 





GEN 


@ 


GEN 


3 


GEN 


lO/'AAl 1" 
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GENERAL FORMAT: Operand_Field_Set_Name. Argument_Field_Set_Name. 

Numeric Label. Label Field_Set_Name PROC, Command _Field_Set_Name . ^ Forward References 

^ Ll_' ^ 

Definition '— 



Numeric Label, Procedure_Name 



\^ Numeric Label 



Call I Numeric_Label, Label_Field_Set 




NAME. Alignment. Label_Field_Symbols_Undefined 



ENDP 



Procedure Name, C ommand__Field_Set 



Argument 



Operand Field_Set 



Figure 4-1. Association of Procedure Definition and Reference Elements 






FUNCTIONS 

Functions are assembly time subroutines normally used where common routines are desired. Unlike procedures, 
which are used for code/data generation or symbol redefinition, functions return a value to their place of 
reference. 



FUNCTION DEFINITION 

A function definition starts with a FUNC directive and ends with an ENDP directive. 

FUNC 

Statement ( A_2 NAME Entry point used in a function reference 
Body < 

ENDP 

Tlie statement body can consists of assembler statements other than the following: 



OUTPUT 


FINIS 


PROC 


LIBP 


GEN 


ENDP 


END 


FUNC 


RES 



When the assembler interprets a FUNC directive, it scans the succeeding lines of source code until a NAME 
directive is encountered. The scan lines are evaluated then but not processed; diagnostics are produced if a 
syntax error is encountered. Comments, are permitted between the FUNC and NAME directives. Lines between 
I the FUNC and NAME directives are not processed at call time. Also: 

• Functions defined in the universal area are at level 1. They are available to all subprograms. 

• Functions defined in the subprogram area are at level 2 and are not available after the END directive 
is processed. 

• Definition nesting is not permitted. 

• Definitions must precede any reference to a function and cannot be redefined. 

• Forward references are not permitted. 

• More than one entry point (NAME directive) is allowed. 

• Symbols defined within a funcfion are not available outside the definition area unless a $ is appended to 
them. 

• A symbol defined at or below the function call level can be referenced within the function, provided a 
$ is appended to the symbol at the definifion level. When function calls are nested, the $ returns the 
search to the original call level (level of the first function call within the nest group). If the symbol is 
not defined at that level, the assembler drops back one level at a time undl the definition is found. The 

same method is used by the assembler when a symbol referenced in an unnested function call is defined 

at a level lower than that of the call. 
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• A name in a Function can call another function. Also a name can call itself. 

• Functions are recursive to 128 levels. 

• If two functions in the library have identical names and if either is called an error message is generated. | 
"MULTIPLY DEFINED SYMBOL". 

FUNC 

Declares the beginning of a function definition, 
numeric-label FUNC p5,p6 *comments 

p5 Optional symbol that becomes the set name for the list of expressions, set element references, 

and symbols that appear as the parameters in the function reference. This set name is made 
available when the function is called. 

p6 Optional symbol that becomes the set name for the operand field set of the NAME directive. 

This set is made available when the function is called. 

Examples 

FUNC A,B 



ENDP A[l]"B[ll 

The parameter set name is A, and the set name for the set list on the NAME directive is B. 

NAME (FUNCTION) 

The NAME directive defines a function name and specifies the entry point of the function when it is called. 
This directive is processed only when it is defined and can be used only within a function or procedure 
definition. 

numeric-label ,p7 NAME Ustl6 *comments I 

p7 Symbol that becomes a function name; it is used to call the function. 

hstl6 Optional list of set elements: all set elements must be completely definable when the function | 

is defined. Forward references are not permitted. Any symbols in this set list must be defined 
in the universal or subprogram area. The set name for this set list is the p6 symbol that 
appears in the FUNC directive. 
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Example 

FUNC B,A 

ABLE NAME 5/'ABCD", P"-2 5" 

ENDP 

ABLE is an entry point name for the function. When the function is called, the set A consists of the 
three elements 5, "ABCD" and P"-25". 

FUNCTION REFERENCES 

A function is referenced by a function name. The function reference includes the function name assigned in 
the label field of the referenced function definition and associated parameters (see figure 4-2). A function 
reference can be made from any command or operand field. The parameter set in a function can contain a 
subset. 

p7 list 11 

p7 Function entry point name that appeared in the label field of a NAME directive in a function 

definition. 

hstll Optional Hst of set elements passed as parameters to the function. 

ENDP (FUNCTION) 

This directive terminates a function. 

numeric-label ENDP p2 *comments 

p2 Optional expression or subset; p2 applies only to function definitions and is ignored if used 

in procedures. The value of p2 is returned as the value of the function call. 

If p2 is not specified a null value is returned. 

EXITP (FUNCTION) 

This directive terminates a function reference before the ENDP directive is encountered. More than one 
EXITP is permitted in a function. 

numeric-label EXITP p2 *comments 

The rules for EXITP are the same as for ENDP. The value returned from the function can be any expression 
or subset. The function need not return a value. 
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Examples 

For additional examples see appendix I 
1. 



Definition 



I 



Call 



FUNC 



ADDER NAME 



EXITP CA[1]+A[2])"B [1] 



NDP 
DENT 



EOU 



GEN 




ADDERCB^2)- 
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This GEN with a function call is equivalent to: 

GEN kO 



A 



FUNC 



NAME 



SET 



ENDP 



IDENT 



PP-^ 



5.2 



/, 



[B,PP[1] ] 



C SET 

Tliis function call is the same as: 



A(3),4 



C SET [[5, 2], 3], 4 

If the statement: 

D SET .ELM.A(l) 

were entered in this example, the result statement would be: 

D SET 15,2],1 

3. 

FUNC A,D 



CHAR 



NAME 



ENDP 
IDENT 



"DPn tt 



REG 



D [1] .CAT. A [1] 



B RDEF CHAR ("FULL") 

This RDEF with a function call is equivalent to: 

B RDEF "REG FULL" 
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GENERAL FORMAT; 



Numeric Label 



Definition 



< 



Numeric Label, Function Name 



V. Numeric Label 



FUNC 



NAME 



ENDP 



CalW Function Name(Call Set)-I 



C all_Set_Name, Argument_Field_Set_Name 

Comments 



Argument 



Comments 



Evaluated_Or_Subset_Returned_As_Value 

Comments 



Figure 4-2. Association of Function Definition and Reference Elements 






SUMMARY OF DIRECTIVES 

The following tables provide the format of each assembler directive, its purpose, and the level at which each 
can be used. Symbols used to specify parameters, P, and lists items, L, are described in the table 4-2. 
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Table 4-1 . Summary of Directives 
General Format: numeric -labeUist-1 name,list-2 list-3 * comments 



Type 


Name/Level 


Format 


Purpose 


I/O 


INPUT/ 1,2 ,n 
OUTPUT/ 1 
LISTING/ 1 
LIBRARY/ 1 


numeric-label INPUT pl0,pll,pl2 *comments 
numeric-label OUTPUT p30 *comments 
numeric-label LISTING pl4,pl5 *comments 
numeric-label LIBP pi 3, llst-15 *comments 


Specific source input format. 

Specifies object deck output format required. 

Specifies assembly listing options. 

Specifies use of library procedures and functions. 


Listing 
Control 


N0LIST/l,2,n 

LIST/ 1,2 ,n 
BRIEF/ 1,2 41 

DETAIL/ 1, 2 ,n 
SPACING/ 1,2 ,n 
EJECT/ 1,2 ,n 
TITLE/ 1,2 ,n 

MESSAGE/1 ,2 ,n 


numeric-label NOLIST *comments 

numeric-label LIST *comments 
numeric -label BRIEF *comments 

numeric-label DETAIL *comments 
numeric-label SPACING p28 *comments 
numeric-label EJECT *comments 
numeric-label TITLE p29 *comments 

numeric-label MESSAGE pi 6 *comments 


Suppresses listing until assembler encounters 
LIST directive. 

Resumes listing suppressed by NOLIST. 

Suppress listing of statements part of procedures 
or functions. 

Lists all procedure and function statements. 

Selects single, double, or triple spacing. 

Resumes listing from top of page. 

Causes a listing eject and places specified 
character string at beginning of all succeeding 
pages. 

Places a character string on the output listing. 



Table 4-1. Summary of Directives (Cont'd) 



Type 


Name/Level 


Formal 


Purpose 


Assembly 
Control 


IDENT/1 

END/2 
FINIS/ 1 


numeric- label, symbol IDENT *comments 
numeric-label END pi *comments 
numeric-label FINIS *comments 


Specifies beginning of subprogram area. 

Specifies end of subprogram area. 

Specifies end of all source statements; 
terminates assembly. 


Conditional 

Assembly 

Control 


Repeat/ 1,2 ,n 
G0T0/l,2,n 


numeric-label, symbol RPT,p26 p27 *comments 
numeric-label G0T0,p9 list 14 *comments 


Specifies number of times source statements 
are to be processed. 

Specifies conditional skip of source statements. 


Subprogram 
Linking 


ENTRY/2 ,n 

EXTD/2,n 

EXTC/2,n 


numeric-label ENTRY list-4 *comments 
numeric-label ,list-6 EXTD,p32 list-25 *comments 
numeric-label,list-6 EXTC,p32 list-25 *comments 


Specifies address ID's and variable ID's defined 
by EQU directives, which can be referenced 
by other subprograms. 

Lists data address identifiers defined vv^ith 
ENTRY directive in data MSEC of another 
subprogram. 

Performs above functions for code address 
identifiers. 


Symbol 
and Set 
Definition 


SET/ 1,2^ 


numeric-labeUist-23 SET list-24 *comments 


Assigns label field symbol as a set name for 
list 24 contents. 



oo 
o 
to 

o 
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Table 4-1 . Summary of Directives (Cont'd) 
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Type 



Assignment 



Data 
Generation 



Location 
Control 



Name/Level 



Rede fine/ 1,2 ,n 
Equivalence/ 1,2 ,n 



FORM/ 1,2 ,n 



Form Reference/2,n 



Generate/2 ,n 



Reserve/2,n 
Memory Section/2,n 
Origin/2,n 
End Origin/2, n 



Format 



numeric-label ,list-5 RDEF p3 *comments 
numeric-label, iist-5 EQU p3 *comments 



numeric-label,list-7 F0RM,p4 list- 8 *comments 



numeric-label ,list-9 form name list-10 *comments 



numeric-label ,list-l 2 GEN,p4,p8 list-13 *comments 



numeric-label,list-17 RES,p4 p25 *comments 
numeric-label,list-17 MSEC pl8,pl9 *comments 
numeric-label,list-26 ORG p21 *comments 
numeric-label EORG *comments 



Purpose 



Assigns or reassigns value and attributes in 
operand field to symbols in label fields. 

Assigns value and attributes in operand field to 
symbols in label field. After a value is assigned, 
symbol cannot be redefined. 



Specifies form name and defines data generating 
format by specifying alignment and field sizes 
in bits. 

Specifies generation of data from expressions 
in list 10 into field of form specified by 
form name referenced. (Form name is specified 
by FORM directive.) 

Specifies generation of data starting at next 
aligned bit. 



Aligns current location counter and adds 
value in operand field to counter. 

Defines control section and specifies it as 
current. 

Sets implied location counter to specified value. 
Activates memory section containing statement. 

Sets current memory secdon to preceding 
memory section specified prior to the last 
MSEC or ORG directive. 



Table 4-1. Summary of Directives (Cont'd) 



Type 


Name/Level 


Format 


Purpose 


Attribute 
Control 


Reference 
Attribute/l,2,n 


numeric-label ,list-21 RATT list-22 *comments 


Adds or changes extrinsic attributes of 
identifiers. 


Procedures 

and 

Functions 


Procedure/ 1,2 

procedure 
reference/ l,2,n 

Function/ 1,2 

function 
reference/ l,2,n 

NAME/ 1,2 

tENDP/l,2,n 
tEXITP/l,2,n 


numeric-label,p22 PROC,p23 p5,p6 *comments 

numeric-label,list-18 p7,list-19 list-20 *comments 

numeric-label FUNC p5,p6 *comments 
p7(list-ll) 

numeric-label,p7 NAME,p33,p20 list-16 *comments 

NOTE: p33 and p20 apply only to PROC's 
numeric-label ENDP p2 *comments 

numeric-label EXITP p2 *comments 


Declares start of procedure definition. 

Calls procedure and passed parameters to it. 

Declares start of function definition. 
Calls function and passes parameters to it. 

Defines function/procedure names and entry 
points. 

Terminates procedure or function; 
parameter p2 is used only with functions. 

Terminates a procedure or function before END 
definition. (More than one EXITP allowed in 
procedure or function.) Parameter p2 is used 
only with functions. 



tp2 applies to functions only. 



oo 
o 
to 
o 
o 



Table 4-2. STAR Assembler Directive Parameters 



Designator 



Pl 

P2 
P3 
p4 

P5 
p6 

p7 

p8 

p9 

plO 

pll 

pl2 

pl3 

pl4 



pl5 
pl6 



Description 



Address identifier used to indicate a transfer address for object deck execution. Must have 
appeared as an entry point name on ENTRY directive. 

Optional expression or subset for function definitions; it is ignored in procedures. 

Any expression; it may not be a set name. 

Bit value for alignment of current location counter. 

Optional symbol that becomes the set name for the list of expressions, set element 
references, and symbols appearing in the operand field of the reference statement. 

Optional symbol that becomes the set name for the set list appearing in the operand field 
of the NAME directive that is the entry point. 

Symbol that becomes a function/procedure name, it can be in the command or operand 
field list of directives or instructions. 

Value indicating number of bits to be reserved for each expression in list 13. 

Indicates what list 14 element is to be selected. 

Beginning column of source code. 

Last column of source code. 

Continuation column of source code. 

Character symbol specifying the name of the source file for procedures or function 
definitions. 

Default: no cross reference. 

1 Cross reference listing is desired. 
f I No cross reference Ust. 

Warning messages are to be omitted from the listing. 

Character string of 128 characters or less to appear on output listing, overriding any 
active listing control directives. 

Optional symbol that becomes the m.emory section nam_e. 
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Table 4-2. STAR Assembler Directive Parameters (Cont'd) 



Designator 


Description 


pl8 


Optional integer that indicates usage restrictions. 




Default is 1 




1 Data MSEC 




2 Code MSEC 




3 Common MSEC 


pl9 


Optional integer constant permitting monitor instructions in this memory section. 




Default or value > 1 or < 1; no monitor instructions allowed. 




1 Monitor instructions are allowed. 


p20 


Optional value of integer constant. 




Default or value > 1 or < 1 - all symbols in label field list of call will be defined as 




address identifiers. 




1 Symbols appearing in label field Hst of procedure call will remain undefined. 


p21 


Any expression that has an integer constant value or a value that has a single memory 




section ordinal number associated with it. The bit value becomes the location counter of 




the memory section implied by the ordinal number. The current memory section is 




asspciated with the ordinal number. 


p22 


Optional symbol that becomes the set name for the list of symbols appearing in the label 




field of the procedure reference statement. 


p23 


Optional symbol that becomes the set name for the list of expressions, set element 




references, and symbols appearing in the command field after the procedure name of the 




procedure reference statement. 


p25 


Optional integer constant; must be a positive bit value, that is added to the current 




location counter after alignment. 


p26 


Indicates number of times succeeding statements are to be processed (if the symbol value 




is not altered within the repeat loop). 


p27 


Identifies a forward numeric label on the statement that is to be the last line repeated. 


p28 


Indicates number of lines to skip after each line Hsted (0,1,2, or 3). 
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Table 4-2. STAR Assembler Directive Parameters (Cont'd) 



Designator 


Description 


p29 


Character string of 64 characters or less to be printed at the top of succeeding pages. 


p30 


If set to 1 , requests debug symbol table dump. 


p31 


Two-digit hexadecimal number specifying the ID of the source file for a procedure or 




function definition. 


p32 


Integer constant; if it evaluates to or null, a full word (EXTD) is generated for each 




symbol in operand list. After loading, it will contain address of designated data entry 




point. For EXTC, two full words are generated; contains address of entry points and 




data area. 


p33 


An optional integer constant; the bit value is the alignment for the current location 




counter when the procedure is called. Default is alignment on bit boundary. 


listl 


Usually, address identifiers and set element references or variable identifiers and set 




element references. 


list2 


Consists of elementary items and expressions. 


list3 


A list of elements separated by commas; made up of elementary items and expressions. 


list4 


Address identifiers oi variable identifiers defined by EQU directives that are made available 




outside the subprogram and defined at the program level. 


lists 


One or more variable identifiers, set element references, or set names separated by commas. 




that assume the value and attributes of p3. 


list6 


Address identifiers that are external to the subprogram. 


list? 


One or more symbols, separated by commas; each symbol becomes the form name used to 




reference the form. 


lists 


Expressions, separated by commas, whose values specify the field sizes of the form in bits. 




Must be integer constants. 


list9 


Address identifiers, separated by commas; the address identifiers assume the value of the 




current location counter after alignment. 


list 10 


A list of expressions, separated by commas. The value of each expression is the data that 




goes into the form_ field. 


list 11 


Optional list of set elements are passed as parameters to the function. Parentheses are not 




optional. 


list 12 

1 

! 


Address identifiers separated by commas. 
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Table 4-2. STAR Assembler Directives List (Cont'd) 



Designator 


Description 


list 13 


Expressions, separated by commas; the value of each expression is the data to be generated. 


list 14 


Elements for which the values indicate forward numeric labels the GOTO can skip. 


list 15 


Procedures or function names separated by commas. 


list 16 


Optional list of set elements. All set elements must be completely definable when the 




procedure or function is defined. 


list 17 


Optional list of address identifiers, separated by commas, which assume the value of the 




current location counter after alignment. 


list 18 


Optional symbols defined as address identifiers, provided the parameter on the called 




NAME line does not indicate they must not be undefined. 


list 19 


Set names, set elements, subsets, symbols, or expressions passed as parameters to the 




procedure. 


list20 


Set names, set elements, subsets, symbols, or expressions passed as parameters to the 




procedure. 


list21 


One or more address identifiers, variable identifiers, set element references, and set 




names for which attributes are to be changed. 


list22 


Elements, separated by commas, of the form N1:N2. 




Nl Attribute number 




N2 Value of extrinsic attribute. 


list23 


One or more variable identifiers, set element references, or set names, separated by commas, 




to become set names for the set list24. 


1 list24 


Set elements (expression, set name, set element reference, or subset) separated by commas. 


j 
list25 


One or more symbols, separated by commas, external to the subprogram. 


! Iist26 


Optional list of address identifiers that assume the value of the current location counter 




after ORG is processed. 
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ASSEMBLER PROVIDED FUNCTIONS AND PROCEDURES 5 



The functions and procedures described in this section are provided as part of the assembler for use during 
program assembly. Functions and procedures described are: 

Conversion functions 
Symbol Creation functions 
Attribute functions 
NOPH procedure 
SHORTER procedure 

NOTE 

Any symbol defined which is the same as a function name or assembler-provided function 
name, may override the function when a call to it is made; therefore results are unpredictable. 

CONVERSION FUNCTIONS 

Conversion functions provide the programmer with a means of changing a value from one constant form to 
another. 

Function Call: 

function-name (expression) 

Table 5-1 lists the current assembler functions. 
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Table 5-1. Conversion Functions 



! 

Function Name 


Function Performed 


ITOC 


Convert an integer or hex constant to an integer value represented as 




character string constant. Leading zeros are suppressed. 


HTOC 


Convert an integer or hex constant to a character string constant 




represented as a hexadecimal value. 


PTOI 


Convert a packed constant to an integer constant. 


ZTOP 


Convert a zoned constant to a packed constant. 


DTOP 


Convert an integer string constant to a packed constant. 


XTOD 


Convert a hex string constant to an integer string constant. 


ITOF 


Convert an integer or hex constant to 64-bit floating point. 


BTOD 


Convert a bit string constant to an integer string constant. 


F32F 


Convert a 32-bit floating point value to 64-bit floating point value. 


FF32 


Convert a 64-bit floating point value to a 32-bit floating point value. 


ZTOC 


Convert a zoned constant to a character string constant. 


PTOZ 


Convert a packed constant to a zoned constant. 


ASSM(pl) 


Return an integer constant depending on the value of pi. 




PI = 1 Current value of error count. 




PI = 2 Current value of warning count. 



NOTE 



For an example of the ITOC and HTOC function, see appendix I. 
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SYMBOL CREATION FUNCTION 

The symbol creation function removes the quotes enclosing the first argument. It is used to convert character 
strings to symbols and to generate symbols. Symbols created by the SYM function will be entered into the 
symbol table. 

SYM (pl,p2,p3) 

pi An expression that evaluates to a character string, ABC etc. Forward references are not 

permitted. No restriction on the characters in pi. i.e. #,-, + , . . . 

p2 Optional. When equal to 1 specifies the inclusion of a $ appended to the symbol, ie., symbol 

is at call level. 

p3 Optional level number for expUcit symbolic control. 

Example 

The following example illustrates symbol creation for use in the label field of a PROC statement. (A second 
example using the function appears in appendix I.) 

P PROC 

CALL-BY-NAME NAME,, 1 

SYMCATT(P[1], 1),1) RDEF 10 

ENDP 
A CALL-BY-NAME 



This call statement results in the equivalent of the following statement; 
AS RDEF 10 

In the SYM (ATT(P[1] ,1),1) statement: 

(P[l],l) Requests the first sub-element of set A which is A; the result is as specified by 

attribute 1 which specifies the expression for use as a symbol. 

,1) Specifies a dollar sign be appended to the symbol. 

The following example illustrates the use of p3: 

1 IDENT 

SYMC'A") EQU 1 *SYMBOL A AT LEVEL 2 

SYM("A",1,1) EQU 2 *SYMBOL A AT LEVEL 1 

GEN A *GENERATES 1 

GEN SYMC'A", 1,1) *GENERATES 2 

-END - 
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ATTRIBUTE FUNCTION 

Attributes may be intrinsic or extrinsic. The use of extrinsic attributes and the RATI directive are described 
in section 4. 



INTRINSIC ATTRIBUTES 

The attribute function followed by the attribute number is used to return the value of the specified attribute. 
The value returned provides information about the symbol referenced in that function. Intrinsic attributes, are 
listed below with the significance of values that can be returned when the attribute is used in an ATT reference. 



ATTRIBUTE 1 



ATTRIBUTE 2 



Symbol as a character string — returned value equals the symbol or set element 
as a character string in quotes. A null character string is returned if there is no 
symbol, e.g.; if: 

a) A GEN 5 
then 

ATT(A,1) retums "A" 

b) B SET A 
then 

ATT(B[1],1) returns "A" 

Mode - retums the mode of the expression as an integer constant. 

Mode Value 



ATTRIBUTE 3 



No value 

Absolute address 

Relocatable address 

External address 

Integer or hexadecimal constant 

Hexadecimal string constant 

Bit string constant 

Qiaracter string constant 

Real constant 

Packed decimal constant 

Zoned decimal constant 

Integer string constant 

Null element; element of a set list is not defined 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 



Memory Section Ordinal Number - retums the ordinal number (integer constant) 
of the memory control section under which the address identifier is defined. A 
zero is returned if there is no ordinal. 
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ATTRIBUTE 4 



Definition Level - returns the definition level as an integer constant. 



ATTRIBUTE 5 



ATTRIBUTE 6 
ATTRIBUTE 7 



Definition Level 

Universal 
Subprogram 
Procedure /Function 

Symbolic Type - returns the symbolic type as an integer constant. 

Symbolic Type 

Undefined 

Redefinable identifier 

Identifier not redefinable 

Set name 

Not an identifier (it is an expression or literal) 



Value 

1 

X 

2 
>3 



Value 


1 

2 
3 
4 



Value Size - returns an integer constant indicating the number of bits needed 
to contain the value of the item. 

Number of Elements - returns the number of elements in the named set as an 
integer constant. If not a set, the value zero is returned. 
B SET 2,3,6,7,4 

GEN ATT(B,7) Returns a value of 5. 



ATT 

The implicit attribute of a symbol or a set element is its value. The value attribute of a symbol is synonymous 
with the symbol; no further notation is needed to obtain that information. 

Example 



A 



RDEF 10 

GEN A 

The use of the A in the GEN statement returns the value attribute which is 10. 
The attribute function is used to obtain attributes other than the value attribute. 
The ATT function returns the value of the indicated attribute, (intrinsic or extrinsic). 

ATT(pl,p2) 

pi The symbol, symbol creation function, or the set element reference of which the attribute is 

to be retrieved. 

p2 An expression with an integer constant value specifying the attribute to be returned. 

Unpredictable results may occur if extrinsic attributes are referenced before they are defined. 



19980200 B 



5-5 



Examples 



1. 



A 



GEN 



The address identified A has the following attributes: 

ATT (A,l) is A 

ATT (A,2) is 2 (assume default MSEC) 

ATT (A,3) is 1 (assume default MSEC) 

ATT (A,4) is 2 (assume statement was in subprogram area) 

ATT (A,5) is 2 

ATT (A,6) is 48 

ATT (A,7) is 



GEN 
GEN 

ATTCA,6) = 
RDEF 

ATTCA,6) = 
RDEF 

ATTCA,6) = 
EOU 

ATlCA^e) = 
SET 5,Z"+12" 
ATT (A [2], 6) = 



5 
D 

48 

"0" 

8 

I"25" 

8 

25 
48 
12 
15 



2. 



01 000000000000 F 
01 000000000040 F 



00000000 00000002 
00000000 00000000 



A 



END 



SET 1,2 

GEN ATTCA,7) 
GEN ATTCA[1],7) 



Referencing a set element returns a null. 
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preset values, qualifiers, or default values. 

NOPH Used for alignment; no code generated. Half-word NO-OP can be used when aligning EXTD 

or EXTC generation in a data MSEC. 

SHORTER ADDRESS is equivalent to: 

BAB,BR \ gj^g / ,address 
For a description of the BAB mnemonic instruction see STAR HARDWARE Reference Manual. 
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GLOSSARY 



Absolute Address 

1. An address permanently assigned by the machine hardware to a particular storage location. 

2. A pattern of characters that identifies a unique storage location without further modification. 
Synonymous with Machine Address. (See Virtual Addressing for Absolute Address). 

Address 

All addresses are 48-bit quantities containing enough information to reference a specific bit. 

Address Identifier 

A designator given to an execution time entity, such as a program point. 

Assemble 

To prepare an object language program from a symbolic language program by substituting machine opera- 
tion codes for symboHc operation codes and virtual addresses for symbolic addresses. 

Assembler Defined Program Areas 

Source code for each assembler program is assigned to one of two assembler defined program areas: 
Universal Area is used for I/O specification; symbol, procedure, function, and set definition. 
Subprogram Area contains executable program statements. 

Assembler Directives 

The symbolic assembler directives control or direct the assembly processor in the same manner that 
machine instructions direct the central computer. Directives are represented by mnemonics. 

Assembler Language Processor 

A language processor that accepts words, statements, and phrases to produce machine instructions. 

Assembly listing 

A printed list presenting the logical instruction sequence. Included is symbolic source notation and actual 
object notation in hexadecimal form established by the assembly process. Relative virtual addresses of 
the assembler generated code are provided also. 

Attribute 

Qiaracteristics of a symbol such as word size, mode of representation (hexadecimal, octal, etc.) The two 
attribute types are: intrinsic (1-7) - predefined. Extrinsic (8-120) - user defined. 
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Base Address 

Address defining the origin or reference point of operands or results. It may be modified by offset or 
index to determine the desired address. 

Byte 

An 8-bit quantity, the address of the left most bit is always a multiple of 8. 

Broadcast Constants 

A 32- or 64-bit * 1 vector element used in some vector instructions to transmit the same vector element 
repeatedly. Broadcast or normal element is selected by machine instruction quaHfiers. 

Conditional Assembly 

A feature of the STAR assembler that allows the user to dictate whether statements' should be assembled 
or not. The user can achieve conditional assembly with the GOTO and RPT directives. 

Control Vector (CV) 

Base address of control vector is contained in Z field of vector and vector macro instructions. Control 
vector determines how many C elements are stored during execution of vector machine instructions and 
determines which pairs of A and B elements are compared during execution of Vector Macro instructions. 
Use is specified in an instruction by Z designator f 0, in which case, Z designator becomes the CV base 
address. 

Elementary Item 

A self defining component of an expression. 

Entry 

Symbol (address identifier), defined in the program that declares the symbol as an entry and can be 
referenced from another program. 

Entry Point 

Label of a source statement where execution or processing can begin. 

Expression 

Series of values, symbols, and functions connected by mnemonic or symbolic operators as required to 
cause computation. 

External Symbol 

A symbol (address identifier) referenced in the program that declares the symbol external but defined 
(given an address value) in another program. 

Form Identifier 

JLA^SlgnclLUi lUVllLii^ilig a iUiill uciiiiiLiun. 
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Forward Reference 
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Function 

Assembly time subroutine normally used where common routines are desired. Functions return a value 
to the point of reference. 

Function/Procedure Identifier 

Designator for entry points defined within a function or procedure. 

Half-word 

A 32-bit quantity, the address of the leftmost bit always is a multiple of 32 (decimal). 

Label 

Labels may be numeric or alphanumeric. Alphanumeric labels comprise the label Hst of the statement 
format; they must start with a letter (maximum size 64 characters). 

Location Counter 

Counter assigned to each memory control section. They are incremented in bits and specify the bit 
location of code and data sections of a user program. 

Location Independent Code 

A sequence of statements containing no addresses. Such code is written to execute correctly from any 
virtual address without modification. 

Memory Control Section 

A specific area is user's virtual memory to which code and data can be assigned. Each MSEC is assigned 
an ordinal number. A maximum of 255 MSEC's can be specified in a user program. 

Code MSEC can contain code and data. Data in this area is assigned to a specific user subprogram. 

Data MSEC can contain information unique to a user's program. 

Common MSEC can contain data tliat may be shared between programs assembled separately but 
loaded together. 

Mnemonic Instruction 

Use of symbolic notation in place of actual machine code. A mnemonic instruction must be translated to 
actual operation codes by assembler procedure references. 

Normalizing a Number 

The coefficient is shifted left until the sign bit does not equal the bit immediately to its right. The 
exponent is reduced by one for each left shift. 
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Offset 

Number used to modify the base address of operands in vector and some non-typical instructions. May 
be half-words or words (determined by number of bits in operand up to ± 2^^"^). 

Order Vector (OV) 

Denotes non -significant elements in vector field. Generated by COMPARE instructions and used by 
COMPRESS instructions to generate sparse vector. Number of ones in order vector determines field length 
of sparse vector operands. A filled result order vector terminates sparse vector instructions. 

Packed BCD Format 

This format is used for decimal arithmetic. Two BCD digits are contained in each byte and the sign is 
right justified. 



BCD DIGIT 



BYTE 



0000 


0001 


1 

1000 


1001 


0011 


1 

1010 







1 


1 

8 


9 


3 


1 

+ 



PACKED BCD FORMAT 

Pre-defmed Symbols 

Symbols with special meaning to the assembler when used in the command field of an assembler statement. 

Procedure 

A subset of source statements meeting a specific purpose that can be repeatedly referenced to generate 
parameterized code. 

Qualifiers 

Symbols to indicate sub-operation of the function code specified by an instruction mnemonic. 

Re-entrant Code 

Code that never modifies itself. This type of code was used in writing this assembler to allow several 
users to employ the same assembler programs simultaneously. 
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Register File 



256 registers of 64 bits each used for instruction and operand addressing, indexing, field length counts; 
source or destination of operands for register instructions. Addressed by 8-bit instruction designator 



Set 



A collection of related elements having a common name. An element may be a set (a subset of a set). 
A reference to an element consists of the set name followed by one or more integers enclosed in brackets 
[ ] indicating the location of the element. 

Source Program 

A program written in assembly language that must be translated into machine language before it can be 
executed. 

Sparse Vector (SV) 

Vector field contracted by removing the non-significant elements to conserve storage space and calculating 
time. Posifional significance of the elements is retained by an order vector for each sparse vector. 

Statement 

An instruction to be interpreted by an assembler. 

Subscript 

One or more integers enclosed by brackets [ ] used to specify a particular element in a set. 

Subprogram 

A part of a program determined by the IDENT directive (start) and terminated by an END directive. 
Unary Operator 

An operator such as the sign of a value (+ or -) that applies to one operand only, rather than causing 
addition or subtraction. 

Vector (VT) 

As used in the matrix algebra, a 32 or 64 x n array of elements. Maximum size is 64 bits x 65,536 
words. Operates on ordered scalar contained in operand fields, rather than single operands. 

Virtual Memory 

A conceptual extension of main storage achieved by hardware technique which permits storage address 
references beyond the physical Hmitation of main storage. Virtual addresses are equated to real addresses 
during program execution. 
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Variable Identifier 

Designation of a single translation time value. 

Word 



A 64-bit quantity. The address of the leftmost bit is always a multiple of 64 (decimal). 

Zoned BCD Format 

Input /output operations use zoned format; one BCD digit is contained in each byte. Sign is leftmost 4 
bits of riglitmost byte. Leftmost 4 bits of all other bytes is called the zone. Instructions are provided 
for packing and unpacking decimal numbers so they may be changed from zoned to packed format and 
vice versa. 



BYTE 



BYTE 



ZONE 



DIGIT 



ZONE 



DIGIT 



SIGN 



DIGIT 



ZONED BCD FORMAT 
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The basic representation of data for the assembler is an elementary item; it may be a delimiter character, 
symbol, variable identifier, constant, operator, etc. This appendix describes all elementary item types that can 
be used with the STAR assembler and provides examples of each type. 

Table A-1 contains a complete list of the STAR character set= Subsequent paragraphs describe the type and 
use of these characters. A list of the operator characters and a description of their use in formulating ex- 
pressions is provided in Appendix B. Delimiters are listed in table A-2, and Special Characters that have an 
implied meaning to the assembler are listed in table A-3. 
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Table A-1. STAR Character Set 



Hex 


1 

Character 


Punch 


Hex 


Character 


Punch 


20 


b space 


no punch 


41 


A 


12-1 


21 


! 


12-8-7 


42 


B 


12-2 


22 


quote 


8-7 


43 


C 


12-3 


23 


# 


8-3 


44 


D 


12-4 


24 


$ 


11-8-3 


45 


E 


12-5 


25 


% 


0-8^ 


46 


F 


12-6 


26 


& ampersand 


12 


47 


G 


12-7 


27 


' apostrophe 


8-5 


48 


H 


12-8 


28 


( 


12-8-5 


49 


I 


12-9 


29 


) 


11-8-5 


4A 


J 


11-1 


2A 


* 


11-8-4 


4B 


K 


11-2 


2B 


+ 


12-8-6 


4C 


L 


11-3 


2C 


, comma 


0-8-3 


4D 


M 


11-4 


2D 


- 


11 


4E 


N 


11-5 


2E 




12-8-3 


4F 





11-6 


2F 


/ 


0-1 


50 


P 


11-7 


30 








51 


Q 


11-8 


31 


1 


1 


52 


R 


11-9 


32 


2 


2 


53 


S 


0-2 


33 


3 


3 


54 


T 


0-3 


34 


4 


4 


55 


U 


0-4 


35 


5 


5 


56 


V 


0-5 


36 


6 


6 


57 


w 


0-6 


37 


7 


7 


58 


X 


0-7 


38 


8 


8 


59 


Y 


0-8 


39 


9 


9 


5A 


Z 


0-9 


3A 




8-2 


5B 


[ opening bracket 


12-8-2 


3B 


■ 


11-8-6 


5C 


\ reverse slash 


0-8-2 


3C 


< 


12-8-4 


5D 


] closing bracket 


1 1-8-2 


3D 


= 


8-6 


5E 


^ circumflex 


11-8-7 


3E 


> 


0-8-6 


5F 


_ underline 


0-8-5 


3F 

40 


7 

@ commercial at 


0-8-7 
8-4 


7B {tre 
7D { tre 


ated as [ 
ated as ] 
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Table A-2. Delimiter Characters 



Delimiter 


Function 


Section Reference 


, (comma) 


Delimits elements in a statement field. 


Section 3 
(Statement Structure) 




Delimits elements in a list and arguments in a procedure 
or function call. 


Section 4 
(Procedures/ functions) 




Delimits subscripts of a set element reference. 


Section 4 
(Referencing Sets) 


( ) parentheses 


Enclose arguments of a function call. 


Section 4 
(Functions) 




Used for grouping in an arithmetic expression or for 
repetition. 


Appendix B 
(Expressions) 


[ ] brackets 


Enclose subscripts for referencing a subset of a set; 
enclose subsets of sets. 

NOTE 

The examples in appendix L show the ( / 
characters which are equivalent to [ ] ; the 
programmer must punch [ ] . 

/\ 

12-8-2 11-8-2 
punch punch 


Section 4 
(Referencing Sets) 


b blank 


Terminates a statement field except in a character 
string constant or comment. 


Section 3 
(Statement Structure) 


quotes 


Encloses character string for a string constant. 


Appendix A 
(Constants) 


: colon 


Indicates ordinal of an element within a set. 
Indicates ordinal of a symbol attribute. 


Section 4 
(Defining Sets) 


# pound sign 


Indicates start of hexadecimal constant. 


Section 4 
(RATT) 


^ circumflex 


Used as escape character in a character string constant; 
indicates the next 2 hex digits form a special ASCII 
character. 


Appendix A 
(Constants) 
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Table A-3. Special Characters 



Special Character 


Function 


Section Reference 


$ 

@ 

* 

& 


Specifies a drop to a lower level of reference; cannot 
be used at level 1. 

Indicates current value of active location counter. The 
@ has the same relocation as the active location counter. 

At beginning of a statement field, indicates the following 
characters comprise a comment. 

Indicates statement continues at next continuation 
begin column. 


Section 2 
(Levels of Symbol 
Reference) 

Section 4 

(Address and Location 
Control) 

Section 3 
(Statement Structure) 

Section 2 
(Statement Structure) 



CONSTANTS 

A constant is a numeric value which cannot be changed by a program. Nine types of constants can be specified 
in a Control Data STAR assembler program: 



Integer 

Integer String 
Hexadecimal 
Hexadecimal String 
Bit String 



Character String 
Packed Decimal 
Zone Decimal 
Real 



The following paragraphs describe the format which is used when writing each constant type in a program. The 
rules described here are summarized in table A^ following the discussion of Real Constants. 



A-4 
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ilNiTEGER CONSTANT 

An integer constant is a signed string of numeric characters (digits) 0-9. The constant is converted to its signed, 
48-bit binary equivalent. 

idi'^it-^strin" 



In data generation, the generated length of an integer constant is 64 bits, sign extended to 48 bits. 
During data generation, if the integer is truncated, the most significant bits are lost. 

GEN #123456789123^+56789 
""""""""" WARNING - CONSTANT TRUNCATED IN OPERAND FIEIJD 
1 0000000002^+0 F 00007891 23^56789 

The maximum significance of the integer is 47 bits excluding sign. 

Integer constants are always right justified, sign-extended in data generation. 

Maximum integer constant is +140,737,488,355,327; the minimum is -140,737,488,355,328. 



Examples: 



Assembler Generated Data 



Integer Constant 


When 64 Bits Requested 


Default Length Requested 





0000000000000000 


0000000000000000 


1 


0000000000000001 


0000000000000001 


IG 


0000000000000010 


0000000000000010 


256 


0000000000000100 


0000000000000100 


409G 


0000000000001000 


0000000000001000 


65535 


OOOOOOOOOOOOFFFF 


OOOOOOOOOOOOFFFF 


-0 


0000000000000000 


0000000000000000 


-1 


FFFFFFFF F.FFFFFFF 


OOOOFFFFFFFFFFFF 


-17 


FFFFFFFF FFFFFFFF 


OOOOFFFFFFFFFFEF 


-328 


FFFFFFFFFFFFFEB8 


0000FFFFFFFFFEB8 


-55823 


FFFFFFFF FFFF25F1 


0000FFFFFFFF25F1 


-40737 


FFFFFFFFFFFF60DF 


0000FFFFFFFF60DF 
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INTEGER STRING CONSTANTS 

An integer string constant is written as the letter i followed by a signed string of numeric characters enclosed 
in quotes. The constant is converted to a signed binary string equivalent. 

l"±digit-string" 

The integer string constant cannot be used in arithmetic expressions. 

In data generation, the default length of an integer string constant is the minimum number of bytes 
needed to represent the signed binary string. 

During data generation, if an integer string is truncated, the most significant bits are lost. When truncation 
occurs a warning message is generated. "WARNING - CONSTANT TRUNCATED IN OPERAND FIELD." 

Integer string constants are right justified, sign-extended in data generation. 

Maximum number of digits is 2*^. 



Examples: 



Integer String 
Constant 

I"0" 

I"+16" 
I"256" 
I"4 09G" 
I"+65535" 
I"-0" 

I"-17" 

I"-328" 

I"-55823" 

I"-40737" 



Assembler Generated Data 
When 64 Bits Requested Default Length Required 



00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 



00000000 
00000001 
00000010 
00000100 
00001000 
OOOOFFFF 
00000000 
OOOOOOFF 
OOOOOOEF 
0000FEB8 
00FF25F1 
00FF60DF 



00 

01 

10 

0100 

1000 

OOFFFF 

00 

FF 

EF 

FEB8 

FF25F1 

FF60DF 
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HEXADECIMAL CONSTANT 

A hexadecimal constant is written as a # (pound sign) followed by a string of hexadecimal characters from 
the set 0-9 and A-F. The constant is converted to a 48-bit binary equivalent. 

±#hexadecimal-character-string 

The default length of a hex constant, in data generation, is 64 bits sign extended to 48 bits. 
When a hex constant is truncated during data generation, the most significant bits are lost. 

GEN #FFFFFFFFFFFFFFFFFF 
jc:::::«cJSJJ5t:tJC WARNING - CONSTANT TRUNCATED IN OPERAND FIELD 



Hexadecimal constants are right justified, sign-extended in data generation. 
The maximum hex constant is: ±#FFFF FFFF FFFF 



Examples: 



Hexadecimal 


Assemoier i 


Constant 


When 64 Bits Requested 


#9 


0000000000000009 


#F 


OOOOOOOOOOOOOOOF 


#FE 


OOOOOOOOOOOOOOFE 


#0F 


OOOOOOOOOOOOOOOF 


+ #FF 


OOOOOOOOOOOOOOFF 


#8000 


0000000000008000 


#08000 


0000000000008000 


#9 


FFFFFFFFFFFFFFF7 


#F 


FFFFFFFFFFFFFFFl 


#FE 


FFFFFFFFFFFFFF02 


#0F 


FFFFFFFFFFFFFFFl 


#FF 


FFFFFFFFFFFFFFOl 


#8000 


FFFFFFFFFFFF8000 


#08000 


FFFFFFFFFFFF8000 



Assembler Generated Data 

Default Length Requested 

0000000000000009 
OOOOOOOOOOOOOOOF 
OOOOOOOOOOOOOOFE 
OOOOOOOOOOOOOOOF 
OOOOOOOOOOOOOOFF 
0000000000008000 
0000000000008000 
0000FFFFFFFFFFF7 
OOOOFFFFFFFFFFFl 
0000FFFFFFFFFF02 
OOOOFFFFFFFFFFFl 
OOOOFFFFFFFFFFOl 
OO00FFFFFFFF8000 
0000FFFFFFFF8000 
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HEXADECIMAL STRING CONSTANT 

A hexadecimal string constant is written as a letter X followed by a string of hexadecimal characters (from the 
set 0-9 and A-F) enclosed in quotes. Each character in the string is converted to a 4-bit hexadecimal equivalent. 

X' 'hexadecimal-character-string' ' 

The hexadecimal string constant cannot be used in arithmetic expressions. 

The default length of a hex string constant, in data generation, is the number of half-bytes (4 bits) 
required to represent the constant. 

Hex string constants are always right justified, zero filled in data generation. 

Maximum number of hex digits is 2^^ 



Examples: 



Assembler Generated Data 
Hexadecimal 

String Constant When 64 bits Requested Default Length Requested 

X"9" 0000000000000009 9 

X"F" OOOOOOOOOOOOOOOF F 

X"FE" OOOOOOOOOOOOOOFE FE 

X"OF" OOOOOOOOOOOOOOOF OF 

X"FF" OOOOOOOOOOOOOOFE FF 

X"8000" 0000000000008000 8000 

X'!08000" 0000000000008000 08000 
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BIT STRING CONSTANT 

A bit string constant is written as a letter B followed by a string of binary digits from the set and 1 enclosed 
in quotes. Each character in the string is converted to a 1-bit binary equivalent. 

B"binary-digit-string" 

The bit-string constant cannot be used in arithmetic expressions. 

The default length of a bit string constant, in data generation, is the number of bits required to represent 
the bit string. 

Bit string constants are right justified and zero-filled when used in data generation. 
Maximum number of bits is 2^^. 



Examples: 



Bit String Assembler Generated Data 

Constant When 64 Bits Requested 

B"l" 0000000000000001 

B"1110" OOOOOOOOOOOOOOOE 

B" 011000" 0000000000000018 

B" 0101.010101" 0000000000000155 

B" 1010101010" 0000 0000 90 000 2AA 
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CHARACTER STRING CONSTANT 

A character string constant is written as a string of ASCII characters enclosed in quotes. Each character is 
converted to an 8-bit byte equivalent representation. 

"character-string 

The character string constant cannot be used in arithmetic expressions. 

The default length of a character string constant, in data generation, is the number of bytes required to 
represent the character string. 

A circumflex in the character string indicates the next 2 hexadecimal characters are to be combined to 
form a special ASCII code. 

The following characters must be inserted by using the circumflex: "(quote), &(ampersand), and 
^ (circumflex), e.g., 'U41" = "A" 

Character string constants are always left justified and blank-filled in data generation. The data generation 
field must be a multiple of bytes. 



The current control section counter must be byte aligned for data generation of character strings. Auto- 
matic alignment occurs if improper ahgnment is detected. When automatic alignment occurs the message: 
AUTOMATIC ALIGNMENT PERFORMED FOR DATA TYPE INDICATED LABELS MAY NOT 
CORRESPOND TO START OF DATA" is issued. 

Maximum number of characters is 2^^. 



Examples: 



Character 
String Constant 

"ASSEriBLER" 



"USES FOR 
ATIPERSAND" 



Assembler Generated Data 
When 192 Bits Requested Defauh Length Requested 



415353454D424C45 
5220202020202020 
2020202020202020 

555345532020464F 
5220414D50455253 
414F442020202020 



415353454D424C45 
52 



555345532020464F 
5220414D50455253 
414F44 
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PACKED DECIMAL CONSTANT 

A packed decimal constant is written as the letter P followed by a signed string of numeric characters enclosed 
in quotes. The constant is converted to its signed BCD equivalent: the rightmost 4 bits contain the size. 

P"±digit-string" 

Packed decimal constants cannot be used in arithmetic expressions. 

The default length of a packed decimal constant, in data generation, is the number of bytes required to 
represent the signed packed decimal constant. 

The most significant bits are lost when truncation is performed. 

Packed decimal constants are always right justified zero-filled in data generation. 

Maximum number of digits 2^^. 

Examples: 

Packed Decimal Assembler Generated Data 

Constants When 64 Bits Requested Default Length Requested 

P"12345" 000000000012345A 12345A 

P"+543" 000000000000543A 543A 

P"-6789" 000000000006789B 06789B 

P"-9876" 000000000009876B 09876B 

ZONED DECIMAL CONSTANT 

A zoned decimal constant is written as the letter Z followed by a signed string of numeric characters enclosed 
in quotes. The constant is converted to its signed ASCII-zoned format with the rightmost byte (an overpunched 
digit) containing the sign and the least significant decimal digit. 

Z"+ digit-string" 

Zoned decimal constants cannot be used in arithmetic expressions. 

The default length of a zoned decimal constant, in data generation, is the number of bytes required to 
represent the signed zoned decimal constant. 

The most significant bits are lost when truncation is performed. 

The current control section counter must be byte aligned for data generation of zoned constants. Auto- 
matic alignment occurs when improper alignment is detected. 

Maximum number of digits is 2^2 
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Examples: 



Assembler Generated Data 



Zoned Decimal 

Constants When 64 Bits Requested Default Length Requested 

Z" 12 345" 3030303132333445 3132 333445 

Z"+543" 3030303030353443 353443 

Z"-6789" 3030303036373852 36373852 

Z"-9876 303030303938374F 3938374F 



REAL CONSTANT 

The formats for signed real constants are: 

±n-,.n2E±n3 for half word 

±ni.n2D±n3 for full word 

The real constant is converted to its internal normalized floating-point equivalent. 

n-, is an optional string of numeric characters. 

n2is a non-empty string of numeric characters. 

n3is an optional string of numeric characters. 

The period is not optional but the E or D and the signs are optional. If neither E nor D is given, the default 
is E. 

When real constants are used in arithmetic expressions, normalized arithmetic is used for add and subtract 
operations; significant arithmetic is used for multiply and divide operations; and the result is always 
normalized. 

The default length of a real constant, in data generation, is an 8-bit exponent, 24-bit coefficient for E 
(32-bit value); or a 16-bit exponent, 48-bit coefficient for D (64-bit value). 

When a real constant is converted to its internal form, the least significant digits are truncated. 

When a real constant is used in data generation, the rightmost bits of the constant are truncated. 

Real constants are always right justified, zero-filled in data generation. 

For -D, maximum number of digits for n-i and n2 combined is 14. 

For E, maximum number of digits for n^ and n2 combined is 7. 

For Dj maximum number of digits for n3 is 4. 

For E, maximum number of digits for n3 is 2. 

If half- and full-word real constants are mixed in arithmetic expressions, the result is a full word. 
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examples: 



Assembler Generated Data 

Real Constants When 64 Bits Requested 

+123.45E+4 FE4B5910 

-123.45E+4 FEB4A6F0 

+123.45E-4 E3652157 

-123.45E-4 E39ADEA9 

123.45D+4 FFE64B59 10000000 

+123.45D-4 FFCB6521 57689CA0 

-123.45D-4 FFCB9ADE A8976360 
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lable A-4. Summary of Rules for Constants 



> 



CONSTANT 
TYPE/FORMAT 


USED IN 

ARITHMETIC 

EXPRESSION 


TRUNCATION 


MAX SIZE/ 
VALUE 


MIN SIZE/ 
VALUE 


DEFAULT 
LENGTH 
AT DATA 
GENERATION 


JUSTIFICATION 
DURING DATA 
GENERATION 


MISCELLANEOUS 


INTEGER 

(+digit 

string) 


YES 


most signi- 
ficant bits 


+140,737, 

488,355, 

327 


-140,737, 

488,355, 

328 


48 bits sign 
extended to 
64 bits 


right justified 
/sign extended 




INTEGER 
STRING 

T'tdigit- 
string") 


NO 


most signi- 
ficant bits 


2'2 digits 




min # of bits 
required to 
represent the #. 


right justified 
/sign extended 




HEXADECIMAL 

(± # hex-char- 
string") 


YES 


most signi- 
ficant bits 


#FFFF 
FFFF 
FFFF 




48 bits sign 
extended to 
64 bits 


right justified 
/sign extended 




HEXADECIMAL 
STRING 
(X"hex-char- 
Mring") 


NO 


most signi- 
ficant bits 


2l2 

hex digits 




min # of half 
-bytes required 
to represent 
the #. 


right justified 
zero-filled 




PIT STRING 

{B"binary- 
fligit-string") 


NO 


most signi- 
ficant bits 


2^2 bits 




# of bits 
required to re- 
present the string 


right justified 
zero-filled 




CHARACTER 
STRING 

("char-string") 


NO 


most signi- 
ficant bits 


2l2 
characters 




# of bytes 
required to re- 
present the Char- 
acter String 


left justified 
/blank filled 
(field genera- 
ted must be a 
byte multiple) 


Current control section 
counter must be byte 
aligned for data gener- 
ation of character string. 
This is accomplished atuo- 
mafically if programmer 
fails to ensure byte 
alignment 


PACKED- 
DECIMAL 

P"±digit- 
string") 


NO 


most signi- 
ficant bits 


2^2 digits 




# of bytes 
required to re- 
present the signed 
packed Decimal 
Constant 


right justified 
/zero-filled 





00 

o 
to 
o 
o 



Table A-4. Summary of Rules for Constants (Cont'd) 



\o 

00 
O 

to 

o 
o 



CONSTANT 


USED IN 


TRUNCATION 


MAX SIZE/ 


MIN SIZE/ 


DEFAULT 


JUSTIFICATION 


MISCELLANEOUS 


TYPE/FORMAT 


ARITHMETIC 
EXPRESSION 




VALUE 


VALUE 


LENGTH 
AT DATA 
GENERATION 


DURING DATA 
GENERATION 




ZONED- 


NO 


most signi- 


2l2 digits 




number of bytes 


right justified 


Current control counter 


DECIMAL 




ficant bits 






required to repre- 


/zero filled; 


must be byte aligned 


(Z"±digit- 
string") 










sent the Zoned 


field must be a 


for data generation. 










Decimal Constant 


multiple of bytes 


automiatically 
















accomplished if pro- 
















grammer fails to assure 
















proper alignment. 


REAL 


YES - 


1) Internal form 


1) D max # 




32 bit-half word 


right justified 


When half and full word 


(±nl .n2E+n3 


normalized 


least significant 


of digits : 




64 bit full word 


/zero filled 


real constants are mixed 


half word) 


add, subtract 


bits 


nl and n2 








in arithmetic operations 


(±nl .n2D+n3 


and normal- 


2) Data Gen- 


(14 digits) 








then result is a fullword 


full word) 


ized signi- 
ficant arith- 
metic for 
multiply and 
divide 


eration most 
significant bits. 


n3 (4 digits) 
2) E max # 
of digits: 
nl and n2 
(7 digits) 
n3 (2 digits) 








value. 



SYMBOLS 

Symbols are formed by combining 1-63 alphabetic characters or numbers; they provide a convenient means of 
referring to program elements. Symbols can be used as: 



Address identifiers 
Variable identifiers 
Function names 
Directive names 



Form names 
Procedure names 
Set names 



For identifying program elements, all the above symbol types, except directive names and instruction mnemonics, 
are entered in ihe label field. The latter two types are entered as described in table A-5. The first character of a 
symbol must be alpha. The remaining symbols may be numeric or an underscore. 



Examples of legal symbols: 

A R_35_X 

BAKER R_l_5 

CHARLIE_1 Z_246_8_10 

SYMBOL RELATED DIAGNOSTICS 

Diagnostics related to the improper construction of a symbol in a label field are listed below. 



********* MISSING OPERATOR IN LABEL FIELD 

Occurs when a $ or @ is embedded in the symbol, or when a symbol starting with a digit is followed by 
a letter without an intervening comma. 



Examples: 

K @ LM 

D3$45 

lABCD 



Embedded @ 

Embedded $ 

Written as 1, A, B, C, D, this would constitute a label list of 5 labels, the first 
being numeric. 
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********* UNMATCHED PAREN IN LABEL FIELD 
1(123 

********* ILLEGAL STRING CONSTANT IN LABEL FIELD 
J"BA 

********* ILLEGAL SYMBOL IN LABEL FIELD 

Occurs when a label field begins with an underscore: 
A123 



Table A-5. Symbol Summary 



Symbol Type 


Location As Identifier 


Location As Reference 


Comments 


Address 


Label field of directives: 




Value of identifier used in 


Identifier 


form call MSEC 
RES FXT 




label field is value of P 
counter after ahgnment. Re- 




GEN ORG 




location attribute is same as 
that of P counter. 




Label field of program 


Command field list/ 


Returns value of address 




statement. 


operand field list of 


identifier when used in 






directives or program 


command/operand list. 






statement. 




Variable 


Label field of directives 






Identifier 


RDEF EQU 
RPT 










Command field list/ 


Returns value of identifier 






operand field list. 


when used in command/ 
operand list. 


Function 


Label field list of NAME 






Name 


directive in a function 
definition. 










Any command/operand 


A function reference calls a 






field list. 


routine to process function 
definition statements. When 






Function reference format: 


this call is terminated by 






Function Name (list of 
operands) 


an EXITP or ENDP directive, 
the vahie of the directives 






operand field list is returned. 
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Table A-5. Symbol Summary (continued) 



Symbol Type 


Location As Identifier 


Location As Reference 


Comments 


Directive 

Name 




Command field followed 
by operands in command 
list and operand list fields. 


This symbol is recognized 
by assembler. A reference 
to a directive name is a 
call to a processor that 
performs the function of 
the directive. 


Form Name 


Label field of FORM 
directive. 










Command field followed 
by operands in operand 
list. 


A form reference is a call 
to a processor that generates 
data defined by a form 
definition and the operands 
in the form reference. 


Procedure 

Name 


Label field of NAME 
directive in procedure 
definition. 




- 






Command field followed 
by command list and 
operand list. 


A procedure reference is a 
call to a processor that 
executes statements in the 
procedure definition until 
an EXITP or END? directive 
occurs. No value is returned. 


Set Name 


Label field of SET 
directive. 

Example: 

BETA SET 3, 6, 9 

label 










Command list or operand 
list fields. 


Returns a value of complete 
set list, contained in brackets. 






Example: 








GEN .ELM.BETA 








operand 
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Table A-5. Symbol Summary (continued) 



Symbol Type 



Instruction 
Mnemonic 



Numeric 
Label 



Location As Identifier 



1 to 14 numeric 
characters (leading 
zeros preceding the 
label field list are 
ignored. 



Location As Reference 



Comments 



Command field followed 
by command and operand 
lists. Symbol recognized 
by the Control Data 
STAR system as a machine 
instruction mnemonic. 



Operand field of RPT a 
and GOTO directives. 



Calls processor that 
generates the machine 
instruction as data. 



Example: 

reference 
GOTO 5 



5 hJ 



identifier in 
label field 
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EXPRESSIONS B 



The Control Data STAR assembler permits the use of simple expressions, consisting of one symbol, and com- 
plex expressions, consisting of two or more symbols connected by an operator. For expressions with more 
than one operation, the order in which each operation is evaluated is determined by the hierarchial level 
assigneu lO me operators. 

Expressions may be arithmetic, relational, logical, or special. Table B-1 lists the operators for each expression 
type, and includes interpretation of each operator, as well as the hierarchial value assigned to it. After reading 
this appendix, refer to figure B-1 which illustrates the evaluation of a logical expression. 

Set or function names cannot be used as an operand in an expression; however, function call with parameter 
lists can. 

Unary operators must preceed an operand 

A unary operator can follow a binary operator without parentheses. 

.BS+4 (valid). Binary operator 

.NOT.-A (invalid unary followed by another unary operator). Must be .NOT.(-A) 
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Table B-1. Operators 



Type 


Operator 


Interpretation 


Heirarchy 


Arithmetic 


+ 


Unary plus 


1 




+ 


Addition 


4 




- 


Unary minus 


1 




- 


Subtraction 


4 




.BS. 


Shift operands to the left of the operator at 


2 




(binary scale) 


assembly time (+ or missing shift left; - shift 
right) by the number of bit positions specified 
by the value to the right of the operator, e.g., 
A.BS.+4 






* 


Multiplication 


3 




/ 


Division 


3 




.GE. 


Condition true if greater than or equal to 


5 


Comparison 


.EQ. 


Condition true if equal 


5 




.NE. 


Condition true if not equal 


5 




.GT. 


Condition true if greater than 


5 




.LT. 


Condition true if less than 


5 




.LE. 


Condition true if less than or equal to 


5 


Logical 


.NOT. 


Logical one's complement (unary) 


1 




.AND. 


Logical product 


7 




.OR. 


Logical or (inclusive or) 


8 


Special 


.CAT. 


Concatenate character string on the left to that 
on the right of this operator. Operands can be: 
expressions, character string, function designator, 
variable identifier, or set designator. All types 
must evaluate to a character string prior to 
concatenation. Result must be a character string, 
e.g., "STAR" .CAT. " ASSEMBLER" results in 
STAR ASSEMBLER. 


1 




.ELM. 


Expand a set to a list of elements. 


1 




.NR. 


Convert the address (external or relocatable) to 






(ignore relocation) 


a 48 bit integer constant by removing the re- 
location ordinal. This occurs at assembly time. 








Give operand to the right the list position 


1 




(positional operator) 


specified by the operand to the left. 






N( ) 


Repetition operator for a list of (elements) 
where N is an expression representing a repeti- 
tion count. N must evaluate to an integer and 
the elements to be repeated can be of any 
operand type permitted in as assembler 
expression including a null. 


1 
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EXPRESSION EVALUATION 

Expressions are evaluated left to right, the operations with lower numbered hierarchies are performed first. 
Parenthesized sub-expressions are expanded from the inside and are performed first. Operators of equal 
hierarchy are evaluated left to right. 

Operations involving the use of relocatable address cannot be performed in the code section of the subprogram; 
i.e., must be performed in the data section. If an operation involving the use of a relocatable address is 
attempted in a code section the following message is generated. 

********** RELOCATION NOT PERMITTED IN CODE MSEC 



ARITHMETIC OPERATIONS 

Arithmetic operators can generate either an integer constant (which could have been associated with a memory 
section ordinal) or a real constant. Integer constants and real constants cannot be mixed in an operation. 
Tables B-3 through B-6 list legal combinations of operand types used in arithmetic operations. 

RELATIONAL OPERATIONS 

The result of a relational operation is an integer constant zero if the operation proves false, or an integer 
constant one if the operation proves true. The comparison method for all relational operations is specified in 
table B-2; a description of allowable combinations of operand types in relational expressions appear in table 
B-7. 



Table B-2. Comparison Methods 


Operand Types 


Method 


Character, bit, and hexadecimal 


Bit comparison. When lengths differ, they 


string constant comparison 


are considered not equal. 


Real constant comparison 


Floating-point compare 


Packed and zoned decimal constant 


Decimal compare 


comparisons 




Integer and hex constant 


Signed integer compare 


comparison 




Integer-string constant comparison 


Binary compare 
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EXPRESSION MODE AND EVALUATION 

As performed by the assembler, expression evaluation determines the data types of the operands and the speci- 
fication of a result and data type based on predefined rules. A mode value, assigned by the assembler, describes 
each data type (operand) used in an expression: 

Mode Value Meaning 

Not a value; for example, set-of-function name 

1 Absolute address 

2 Relocatable address 

3 External address 

4 Integer or hexadecimal constant 

5 Hexadecimal string constant 

6 Bit string constant 

7 Character string constant 

8 Real constant 

9 Packed decimal constant 

10 Zoned decimal constant 

1 1 Integer string constant 

12 Null element; element of set Hst is not defined. Element value is zero. 



The following tables (B-3 through B-6) provide the allowable combinations of operand types (modes) for a 
given operation and the data type (mode) of the result of the operation. The mode result of each operation 
is contained within the appropriate blocks. An asterisk result indicates that the combination of operands is 

not permitted. 







Table B-3. 


Unary + - Operations 




+ _ 




Right Operand 








Relocatable 


Integer Hex 


Real 


Absolute 




Address 


Constant Constant 


Constant 


Address 




Relocatable 


Integer 


Hex 


Real 


Absolute 




Address 


Constant 


Constant 


Constant 


Address 



M 
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Table B4. Binary Scale Operations (.BS.) 







Right Operand 






Integer 
Constant 


Hex 
Constant 


Real 
Constant 


Integer 


Integer 
Constant 


Integer 
Constant 


* 


Left Hex 


Hex 


Hex 


* 


Operand Constant 


Constant 


Constant 




Real 


Real 


Real 


* 


Constant 


Constant 


Constant 




For example: 








00 000000000003 
01 OOOOOOOOOO^tO E 00000000 00000006 
01 000000000080 F 00000000 00000001 


C EQU ; 
GEN 
GEN 


5 

C.BS.+l 
C.BS.-l 



00 0000000000006 
00 0000000000006 
00 00000000000B2 



AA EQU #3.BS.+ttl 
BB" EQU #3.BS.+1 
CC EQU 89.BS.+#1 



Table B-5. Multiply and Divide Operations (* /) 

Right Operand 





Integer 




Constant 


Left 


Hex 


Operand 


Constant 




Real 




Constant 



Integer 
Constant 



Hex 

Constant 



Real 
Constant 



Integer 
Constant 


Integer 
Constant 


* 


Hex 

Constant 


Hex 

Constant 


* 


* 


* 


Real 
Constant 
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Table B-6. Add and Subtract Operations (+ -) 

Right Operand 





External 




Address 




Relocatable 




Address 


Left 


Integer 


Operand 


Constant 




Hex 




Constant 




Real 




Constant 



External 
Address 



Relocatable 
Address 



Integer 
Constant 



Hex 
Constant 



Real 
Constant 



External 


* 


External 


External 


* 


Address 




Address 


Address 




* 


Relocatable 


Relocatable 


Relocatable 


* 




Address 


Address 


Address 




* 


Relocatable 


Integer 


Integer 


* 




Address 


Constant 


Constant 




External 


Relocatable 


Hex 


Hex 


* 


Address 


Address 


Constant 


Constant 




* 


* 


* 


* 


Real 
Constant 



B^6 
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Table B-7. Relational Operations (EQ, NE, GT, GE, LT, LE) 
Right Operand 



> 










Hex- 


Bit- 


Char- 




Packed- 


Zoned- 


Integer- 




Relocatable 


Relocatable 
Address 


Integer 
Constant 


Hex 
Constant 


String 
Constant 


Strmg 
Constant 


String 
Constant 


Real 
Constant 


Decimal 
Constant 


Decimal 
Constant 


String 
Constant 




INT 


* 


* 


* 


* 


* 


* 


* 


* 


* 




Address 


Constant 






















Integer(INT) 
Constant 


* 


INT 

Constant 


INT 
Constant 


* 


* 


* 


* 


* 


* 


* 




Hex 


* 


INT 


INT 


* 


* 


* 


* 


* 


* 


* 




Constant 




Constant 


Constant 


















HeX'String 

(STR) 

Constant 


* 


* 


* 


INT 

Constant 


* 


* 


* 


* 


* 


* 




Bit-String 
Constant 


* 


* 


* 


* 


INT 

Constant 


* 


* 


* 


* 


* 


Left 


Char-String 


* 


* 


* 


* 


* 


INT 


* 


* 


* 


* 


Operand 


Constant 












Constant 












Real 
Constant 


* 


* 


* 


* 


* 


* 


INT 

Constant 


* 


* 


* 




Packed- 
Decimal 


* 


* 


* 


* 


* 


* 


* 


INT 

Constant 


* 


* 




Constant 
























Zoned- 
Decimal 


* 


* 


* 


* 


* 


* 


* 


* 


INT 

Constant 


* 




Constant 
























Integer(INT) 
String(STR) 
Constant 


* 


* 


* 


* 


* 


* 


* 


* 


* 


INT 

Constant 



I LOGICAL OPERATIONS 

Logical operations are performed left to right and bit by bit. If operands are unequal in length, the shorter is 
left justified and right extended with zeros until both are equal in length. Allowable combinations of operands 
in logical operations appear in table B-8. 



Table B-8. Logical Operations (AND, OR) 
For a unary .NOT. operation, the result length is that of the operand being evaluated. 



Right Operand 

Integer- Bit- Char- Packed- Zoned- 

Integer Hex String String String Real Decimal Decimal 

Constant Constant Constant Constant Constant Constant Constant Constant 



Relocatable 
Address 

Integer 
Constant 

Integer- 
String 
Constant 

Hex 

Constant 

Left Bit-String 

Operand Constant 

Char-String 
Constant 

Real 
Constant 

Packed- 
Decimal 
Constant 

Zoned- 

Decimal 

Constant 







Mode 


1 1 
and length of left operand 










Mode and length of left operand 
1 1 










Mode 
Mode 


and length 
and length 


of left operand 
of left operand 










Mode 


and length 


of left ope 


rand 










Mode 
Mode 


and length 
and length 


of left ope 
of left ope 


rand 
rand 










Mode 


and length 


of left ope 


rand 




.■ 






Mode 


and length 


of left ope 


rand 







B-8 
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00 

o 
to 
o 
o 



Expression 



.NOT.(O.EQ..NOT. (D.Eaj) 




EXPLANATKJN 

o) BkRENS EVALUATED FIRST 
NOT HAS HIGHEST HIERARCHY 

a) Parens e\majated 

1) - IS A Unary Operator and ir«)»CATEs 

2'S COMPLEMENT 

2) I IS A 48-BIT Integer Constant 

3) The combination of the two 

b) NOT performs a Is complement 

2) Since there are 2 EQ's. evaluation continues 

FROM LEFT TO RIGHT. 

o) IS A 48- BIT Integer Constant 

b) When Relational Operators are evaluated they 

RETURN A 48-BIT INTEGER CONSTANT OF ONE FOR 
TRUE OR ZERO FOR FALSE. 

c) The expression evaluates to be true 

3) Complete evaluation of rwens 

a) I is a 48-bit INTEGER CONSTANT 

b) The expression evaluates to be true 

b) The complete expression is now NQTted 
[fs complement] 



Hex 
Representation 



0000 00000001 

ffff ffff ffff 

000000000000 
00000000 0000 

000000000001 

0000 00000001 
000000000001 

ffff ffff ffff 



Moog 



Integer Constant 
Integer Constant 
Integer Constant 

Integer Constant 

Integer Constant 

Integer Constant 
Integer Constant 

Inteoer C(»«tant 



Operator 



NOT 
EQ 



Hierarchy 



EQ 



EQ 



CO 



Figure B-1. Expression Hierarchial Evaluation 



STAR MACHINE INSTRUCTIONS 



STAR instructions may be classified into ten categories: Register, Index, Branch, Vector, Sparse Vector, Vector 
Macro, String, Logical String, Non-Typical, and Monitor. Instruction size is either 32 bits or 64 bits and formats 
vary within an instruction group. 

GENERAL FORMAT 

The general format for a symboUc machine instruction is identical to that of a procedure reference: 



Numeric Label, List 



Mnemonic, Qualifiers 



Operands 



LABEL FIELD 

The label field consists of an optional numeric label followed by an optional list of symbols separated by 
commas. The symbols are defined to be address identifiers and are given the value of the current location 
counter after alignment. They are used to define locations at assembly time and do not become part of the 
32-bit or 64-bit instructions. 



COMMAND FIELD 

The command field consists of mnemonics and associated quahfiers. Mnemonics specify the machine instruction 
to be generated. (They are mapped into the 8-bit function field.) Every instruction function code has a dif- 
ferent mnemonic. The mnemonic symbol can be used as an address identifier, variable identifier, set name, 
and function name without redefining the mnemonic as a machine instruction. Defining a mnemonic symbol to 
be a procedure name or form name results in instruction redefinition; theiefore, use of that machine instruction 
is lost. 

Command field qualifiers are lists of symbols that indicate a sub-operation of the function code specified by the 
instruction mnemonic. Quahfiers are not reserved symbols and definition of a qualifier symbol by a user does 
not alter its value as qualifier to an instruction. The user can define his own qualifiers, provided the symbols 
differ from those qualifiers supphed by the assembler. The assembler checks user defined qualifiers to ensure 
that the sub-operation specified can be performed. Assembler supplied qualifiers are listed in table C-1 . 
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Table C-1 Qualifiers 







Hex 




Qualifier 


Meaning 


Value 


Default (value is GO) 


A 


Broadcast A operand 


10 


No broadcast of A 


B 


Broadcast B operand 


08 


No broadcast of B 


BR 


Branch unconditionally 


40 


Do not branch 


BRB 


Branch backward 


06 


Branch to (Y) + (B) 


BRF 


Branch forward 


04 


Branch to (Y) + (B) 


BRO 


Branch on one 


80 


Do not branch 


BRZ 


Branch on zero 


CO 


Do not branch 


C 


Complement A operand 


02 


Normal A operand 


CH 


Destination C is half word 


08 


Destination C is full word 


D 


Character deUmiter for A and B 


80 


Count delimited for A and B operands 


DC 


Character delimiter for destination C 


20 


Count delimited for destination C 


DD 


Double character delimiter for A 
and B operands 


CO 


Count delimited for A and B operands 


DDC 


Double character delimiter for 
destination C 


30 


Count deUmited for destination C 


DM 


Character mask delimiter for A 


40 


Count delimited for A and B 




and B operands 




operands 


H 


Half word operand 


80 


Full word operands 


LH 


Start at last hit 


20 


Starts over 


MA 


Magnitude of A operand 


04 


Normal A operand 


MB 


Magnitude of B operand 


01 


Normal B operand 


N 


Negative A operand 


06 


Normal A operand 


NCC 


No conflict checking 


01 


Conflict checking 


NIX 


Do not increment X 


04 


Increment 


NIY 


Do not increment Y 


02 


Increment 


NIZ 


Do not increment Z 


01 


Increment 


NS 


Packed to zoned no sign 


CO 


Normal zone sign 





Offset destination and control vector 


20 


No offset 


SO 


Set bit to one 


20 


Do not alter bit 


ss 


Zoned 8 bit sign to packed or packed 
to zoned 8 bit sign 


80 


Normal zone sign 


sz 


Set bit to zero 


30 


Do not alter bit 


T 


Toggle bit 


10 


Do not alter bit 


Z 


Control vector on zeroes 


40 


Control vector on ones 



C-2 
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OPERAND FIELD 

The instruction operand field lists all operands to be used with the instruction. Combination of operand types 

■.J1J.M.V vU^jL -w V x*iJV-» tT A«-ii **ii .KxxuvjL lAx/fA^ax v»x/^Vaxx*ui x^ax i,xxw xx^xxixui. %.y ^V i\-/i UJ.XV X1101.X U-VCXV/ll,. i W WX ¥W IVXltiUt. I-V yv*3 

(categories) are available. A particular form type is usually, but not necessarily, common to a group or groups 
of instructions. 



Operand Form 
[0P1,0P2] 
[OPl] 
[,0P2] 



Meaning 

Operand 1 offset or indexed by operand 2 (see table C-10 vector instructions) 

Operand 1 offset or indexed by zero 

Zero offset or indexed by operand 2 I 



Each format type includes a corresponding instruction designator portion. Most formats are divided into lengths 
of 8-bit characters. The following drawings illustrate available instruction formats and specify the contents of 
each format division. Cross-hatching denotes undefined areas which must be zero filled. The assembler automati- 
cally generates zero fill for these areas. A description of the designators used in the format layouts appears 
in table C-2. 



(FUNCTION) 



(SrB-FUNCTK)N) 



(OFl-.SET FOR A) 



(LKNGTH AND 
RASE ADDRESS) 



(OFFSET FOR R) 



(EENGTH AND 
BASE ADDRESS) 



(CONTROL VECTOR 
BASE ADDRESS) 



(LENGTH AND 
BASE ADDRESS) 



FOR\LAT I - USED FOR VECTOR. \'ECTOR :\!ACRO, AND SOME NON-TVPICAL INSTRUCTIONS 



C + 1 

! (OFFSET j 

FOR C & Z) I 



FUNCTION 



(SI"R- FUNCTION) 



(ORDER VECTOR 
LENGTH ^- RASE) 



(RASE ADDRESS) 



(ORDER VECTOR 

LENGTH AND 
RASE ADDRESS) 



(BASE ADDRESS) 



(ORDER VECTOR 

LENGTH AND 
BASE ADDRESS) 



C 

RESULT 

LENGTH AND 

BASE ADDRESS 



FORMAT 2 - USED FOR SPARSE V'ECTOR AND SOME NON-TYPICAL INSTRUCTIONS 



(FUNCTION) 



(SUB- FUNCTION) 



(IND]:X l"OR A) 



(LENGTH AND 
RASE ADDRESS) 



(INDEX FOR B) 



(LENGTH AND 
RASE ADDRESS) 



(INDEX FOR C) 



(LENGTH AND 
BASE ADDRESS) 



FOR:ViAT 3 - USED FOR LOGICAL STRING AND STRING INSTIUXTIONS 



F 
(FUNCTION) 


R 
(SOURCE 1) 


S 
(SOURCE 2) 


T 
(DESTINATION) 



FORAIAT 4 - USED FOR SOME REGISTER, ALL MONITOR. THE 3D AND 04 NON-TYPICAL INSTRUCTIONS 
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F 
(FUNCTION) 


R 
(DESTINATION) 


I (48 BITS) 



FORMAT 5 - USED FOR THE BE. BF, CD AND CE INDEX INSTRUCTIONS AND FOR THE B6 BRANCH INSTRUCTION 
7 8 15 16 31 



F 
(FUNCTION) 


- R 

(DESTINATION) 


I 
(16 BITS) 



FOPMAT 6 - USED FOR THE 3E, 3F, 4D AND 4E INDEX INSTRUCTIONS AND THE 2A REGISTER INSTRUCTION 
7 8 15 16 23 24 31 



F 
(FUNCTION) 


R 


S 


T 
(BASE ADDRESS) 



FORMAT 7 - USED FOR SOME BRANCH AND NON-TYPICAL INSTRUCTIONS 
7 8 15 16 23 24 31 



F 
(FUNCTION) 


R 
(REGISTER) 


S 
(REGISTER) 


T 
(BASE ADDRESS) 



FORMAT 8 - USED FOR SOME BRANCH INSTRUCTIONS 
7 8 15 16 23 24 



F 
(FUNCTION) 


G 
DESIGNATOR 


S 
(BIT TEST 
ADDRESS) 


T 



FORMAT 9 - USED FOR THE 32 BRANCH INSTRUCTION 

■? 8 15 16 23 24 







^//// 


///// 




F 
(FUNCTION) 


R 
(OLD STATE) 


m 


m 


T 
(NEW STATE) 



UNDEFINED 
(MUST BE "O'S") 



FORMAT A - USED FOR SOME INDEX, BRANCH, AND REGISTER INSTRUCTIONS 



C-4 
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UNDEFINED 
(MUST BE "O'S") 



A 



F 
(FUNCTION) 


G 
DESIGNATOR 




T 
(BASE ADDRESS) 



FORMAT B - USED FOR THE 33 BRANCH INSTRUCTION 



y. 



G -DESIGNATOR 
A 



\. 



7 8 12 1314 15 16 



(FUNCTION) 




X 
(REGISTER) 



REGISTER 



\ ,, /^ 



UNDEFINED BRANCH CONTROL BITS 

(MUST BE "O'S") 



FORMAT C - USED FOR THE B0-B5 BRANCH INSTRUCTIONS 



(INDEX) 



(BASE ADDRESS) 



(REGISTER) 



(REGISTER) 
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Table C-2. Instruction Designators 



Designator 


Format Type 


Definition 


A 


1 & 3 


Specifies a register that contains a field length and base address for the 
corresponding source vector or string field. 




2 


Specifies a register that contains the base address for a source sparse vector 
field. 




C 


Specifies a register that contains a two's complement integer in the right- 
most 48 bits. 


B 


1 & 3 


Specifies a register that contains a field length and base address for the 
corresponding source vector or string field. 




2 


Specifies a register that contains the base address for a source sparse 
vector field. 




C 


Specifies a register that contains the branch base address in the rightmost 
48 bits. 


C 


1,2, & 3 


Specifies a register that contains the field length and base address for 
storing the result vector, sparse vector, or string field. 




C 


Specifies the register that will contain the two's complement sum of (A) 
+ (X) in the rightmost 48 bits. The leftmost 16 bits are cleared. 


C + 1 


1 


Specifies a register containing the offset for C and Z vector fields. 


d 


9 & B 


2-bit designator specifying branch condifions. 


e 


9 & B 


2-bit designator specifying object bit altering conditions for the corres- 
ponding branch instructions. 


F 


1 - C 


8-bit designator used in all instruction format types to specify instruction 
function code. It is always contained in the leftmost 8 bits of the 
instruction and is expressed in hexadecimal for all instruction descriptions. 
Thus, the function code range is OO-FFj^; however, not all possible 
function codes are used. 


G 


1, 2, 3, 9, 


8-bit designator specifies certain sub-function conditions. Sub-functions 




B, & C 


include length of operands (32- or 64-bit), normal or broadcast source 
vectors, etc. The number of bits used in the G designator varies with 
instructions. 



C-6 
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Table C-2. Instruction Designators (Cont'd) 



Designator 



R 



Format Type 



Definition 



5 & 6 



7, 8, & A 



1,S,&9 



7, 8, 9, & B 



1 & 3 



48-bit index used to form the branch address in a B6 branch instruction. 
In BE and BF index instructions, I is a 48-bit operand. 

In 3E and 3F index instructions, I is a 16-bit operand. 

In the 33 branch instruction, the 6-bit I is the number of the DFB object 
bits used in the branching operation. 

In the register and 3D instructions, R is the register containing an operand 
to be used in an arithmetic operation. 

In the 3E, 3F, BE, and BF index instructions, R is a destination register 
for the transfer of an operand or operand sum. In the B6 branch 
instruction, this register contains an item count used to form the branch 
address. 

R specifies registers and branching conditions given in the individual 
instruction descriptions 

In the register and 3D instructions, S is a register containing an operand to 
be used in an arithmetic operation. 

S specifies registers and branching conditions given in the individual 
instruction descriptions 

T specifies a destination register for the transfer of the arithmetic results. 

T specifies a register that contains the base address and, in some cases, the 
field length of the corresponding result field or branch address. 

T specifies a register containing the old state of a register, DFB register, 
etc; in an index, branch, or inter-register transfer operation. 

Specifies a register that contains the offset or index for vector or string 
source field A. 

Specifies a register that contains length and base address for order vector 
corresponding to source sparse vector field A. 

In the B0-B5 Branch instructions; this register contains a signed, two's- 
complement integer in the rightmost 48 bits used as an operand in the 
branching operation 
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Table C-2. Instruction Designators (Cont'd) 



Designator 


Format Type 


Definition 


Y 
Z 


1 & 3 

2 

C 

1 

2 

3 
C 


Specifies a register that contains the offset or index for vector or string 
field B. 

Specifies a register that contains the length and base address for the 
order vector corresponding to source sparse vector field B. 

In the B0-B5 Branch instructions, Y specifies a register that contains an 
index used to form the branch address. 

Z specifies a register that contains the base address for the order vector 
used to control the result vector in field C. 

Z specifies a register that contains the length and base address for the 
order vector corresponding to result sparse vector field C. 

Z specifies a register that contains the index for result field C. 

In the B0-B5 Branch instructions, Z specifies a register that contains a 
signed, two's-complement integer in the rightmost 48-bits. It is used as 
the comparison operand in determining whether the branch condition is 
met. 



INSTRUCTION TYPES 

Each STAR instruction type is discussed in the following paragraphs. Tables C-6 through C-15 hst the 
instructions including: OP code, format (F) instruction mnemonic, appUcable operand types, qualifiers, and 
concise description. 



The following categories are described: 



Register 
Index 
Branch 
Vector 
Sparse Vector 



Vector Macro 
String 

Logical String 
Non-Typical 
Monitor 



For a complete description of each instruction included in the STAR set, see Engineering Specification 
11845800 (STAR INSTRUCTION DESCRIPTIONS). 



C-8 
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REGISTER INSTRUCTIONS 

inC olAiv register ILlc COiiM5i2> oi DA- aiiu ot-uii icgisigis. lu atJuoiiimuuiiLC uic use ui Duui icgisici types, 

the STAR instruction set includes instructions which access the register file as half words (32 bits) or full 
words (64 bits). 



F 


R 


S 


T 



In the register instructions, all source and result destinations are registers; R, S, T, each designate the contents 
of one of 256 registers. Unless specified, in register-to-register operations the source registers are unchanged and 
the destination registers are cleared before the result is entered. 

Any register except OOj^ can contain one or both source operands or a result. For a description of the proper 
use of register 00^ 5, see the Chapter 3, Register File description (paragraph 3.1.7), in Engineering Specification 
11845800 (STAR INSTRUCTION DESCRIPTIONS). 

INDEX INSTRUCTIONS 

Index instructions are used primarily for numerical calculations on field lengths and addresses. The index instruc- 
tions manipulate either the low order 24 bits of a half word or the low order 48 bits of a full word in designated I 
operational registers. Some index instructions are used for manipulating the high order 8 bits of a half word 
or the high order 16 bits of a full word in the designated operational registers. 



BRANCH INSTRUCTIONS 

The branch instructions can be used to compare or examine single bits, 48-bit indexes, 32-bit floating-point 
operands, or 64-bit operands. Results of comparison determine whether the program continues with the next 
sequential instruction (branch condition not met) or branches to a different instruction sequence (branch 
condition met). The instruction sequence can consist of one or more instructions beginning at the branch 
address specified in the branch instruction format. For instructions which require index operations, all item 
counts are in half-word increments. 

The following comparison rules apply to branch instructions. 

If the signs of the coefficients of two operands are unlike, the operands are unequal. 

If one operand is indefinite, the compare condition is not met since indefinite is not > < or = 

to any other operand. If both operands are indefinite the = and > conditions can be met since indefinite 

equals indefinite. 

If neither operand is indefinite but both operands are machine zero: 

A non-indefinite, machine-zero operand with a positive, non-zero coefficient is greater than machine 
zero. 

A non-indefinite, non-machine zero operand with a negative coefficient is less than machine zero. 



19980200 B C-9 



Machine zero is considered equal only to itself and to any number having a finite exponent and a 
zero coefficient. 

Machine zero is represented as: 

8X XXXXXX (32 bits) 

8XXX XXXXXX XXXXXX (64 bits) 

where: X equals any hexadecimal digit. 
An indefinite number is represented as: 

7X XXXXXX (32 bits) 

or 

7XXX XXXXXX (64 bits) 

where: X equals any hexadecimal digit. 

VECTOR INSTRUCTIONS 

The vector instructions perform operations on ordered elements (scalars). These instructions read the scalars, 
in 32-bit or 64-bit floating-point operand form, from consecutive storage locations over a specified address 
range (field). Vector instructions perform a designated operation on each set of operands and store the results 
in consecutive addresses of a result field, beginning with a specified address. A vector can contain as many as 
65, 536 items. 

The following terms are critical to the understanding of the vector instructions, these terms are fully described 
in Engineering Specification 11845800. 

Order Vector (OV) - A bit string denoting non-significant elements in a vector field. An order vector can be 
generated by compare instructions and used by compress instructions to generate a sparse vector. The number 
of ones in the order vector determines field length of sparse vector operands. A filled result (order vector) 
terminates sparse vector instructions. 

Sparse Vector (SV) - Vector field contracted by removing the non-significant elements to conserve storage 
space and calculation time. Positional significance of the elements is retained by an order vector for each 
sparse vector. 

Control Vector (CV) - Base address of control vector is contained in Z field of vector instructions and vector 
macro instructions. A control vector determines how many results (C elements) are stored during execution of 
vector instructions and determines which pairs of A and B elements are compared during Vector Macro 
operations. Use is specified in an instruction by Z-designator f 0; the Z designator becomes the CV base address. 

Broadcast - Repeated transmission of the same vector element from the register file. Selection of a broadcast 
or normal element is specified by the state of the G designator of the appUcable vector instruction. (See 
Qualifiers) 
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Offset — Number used to modify the base address of operands in vector and some non-typical instructions. 
An offset can be in half words or words (determined by number of bits in operand up to + 2^^-l). 

Significance - Bit count for a floating point number which is equal to the number of bit positions in the 
coefficient (excluding the sign bit) minus the left shift count required to normalize the number. 

Control vector, offset, as well as, operand sign content and size are selected through sub-function bits in the 
vector instruction. These sub-functions are listed in table (C-3). 

If the Z designator in format 1 instruction is zero, a control vector is not used; therefore bit 9 becomes 
undefined. If bits 11 and/or 12 of G = 1, the A and/or B designators denote a constant used as each element 
of the respective vector field. The instruction ignores associated offsets in this case. The registers specified by 
A and/or B contain these constants. | 



Table C-3. Vector Instruction Sub-function Bits 



Bit 


State 


Sub-function 


8 





64-bit operands (words) 






1 


32-bit operands (1/2 words) 




9 





Control vector operates on I's 






1 


Control vector operates on O's 




10 





No offset for result field and control vector 






1 


Offset for result field and control vector 




11 


1 


Normal source vectors — A 






1 


Broadcast repeated (A) 




12 





Normal source vectors — B 






1 


Broadcast repeated" (B) 




13 


X 


Sign controlt (These bits must be for all instructions other than 80, 81 


,82, 


14 


X 


84, 85, 86, 88, 89, 93tt, 8B, 8C, 8F, CF, D8tt, and D9tt instructions. 


See 


15 


X 


table C4. 





flf both vectors A and B are broadcast constants, instructions that do not terminate by filling the result 
field (e.g., Select instructions -CO -C3) produce undefined results, 
ttin these instructions, only bits 13 and 14 are used. Bit 15 must be 0. 
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Table C4. Vector Instruction Sign Control Sub-function Bits 


Bit 13 


Bit 14 


Bit 15 


Control Operation 








or 1 


Operands from the A stream are used in normal manner. 





1 


or 1 


Coefficients of operands from the A stream are 2's comple- 
mented before they are used. Any required significance cal- 
culation is performed before complementing. 


1 





or 1 


Magnitude of operands from the A stream is used. 


1 


1 


or 1 


Coefficients of all positive operands from the A stream 
are made negative before they are used. Negative oper- 
ands are not altered. 


or 1 


or 1 





Operands from the B stream are used in normal 
manner. 


or 1 


or 1 


1 


Magnitude of coefficients of operands from the B stream 
is used. 



Field lengths, Base Address, and Offsets 

The operation of subtracting the- offset from the field length must result in a positive vector length less than 
2^^ in magnitude. If the resulting vector does not meet these requirements, it is treated as a zero vector length. 
The beginning address is obtained by adding the offset (including sign extension) to the base address. 



Field 
Length 



Base 



Positive 
Offset 



Beginning Address 
(Base & Offset) 

Vector Field 
(used portion) 



c-i: 
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CONTROL VECTOR 

When the format 1 instruction specifies a control vector (Z designator = 0), a single bit from the vector 
controls how each element is stored in the result field. When a bit from the control vector prohibits the 
storing of a result element, the instruction does not alter the previous contents of the corresponding storage 
address. Therefore, the nth bit read from the control vector prohibits or permits the storing of the nth result 
in the result vector field. 

As specified in Table C-3, bit 9 of the G designator selects whether a or 1 control vector bit permits the 
result to be stored. If bit 9 of the G designator is a or a 1, the instruction stores the nth result provided 
the nth bit of the control vector is identical to that specified in the G designator. 

The rightmost 48 bits of the register designated by Z contain the base address of the control vector. The con- 
trol vector field length is the same as the field length for result vector C. 

The addition of the offset and base address provides the starting address of the control vector. Since offsets 
are item counts, the result vector and control vector use the same offset; however, the control vector offset 
represents a bit offset. 

VECTOR INSTRUCTION TERMINATION 

Vector instructions terminate when the result vector field is filled. In format 1, when the C designator is zero or 
the modified field length is zero or negative, the instruction becomes a no-operation (no-op) instruction. The modi- 
fied C vector length equals the C vector length minus the offset. If the instruction uses no C vector offset, 
the modified field length equals the C vector field length. The instruction extends short or zero length source 
vector fields, as required, with machine zeros in additive operations or normalized source vector fields in 
multiply or divide operations. 



VECTOR MACRO INSTRUCTIONS 

Vector macro instructions perform operations similar to vector instructions; however, some vector macro 
instructions do not form result vector fields. For these instructions, the control vector contains neither length 
nor offset; rather it controls the use of source vector elements. 

Bit 10 of the G designator for this instruction must be set to 0. Designators C and C + 1 denote 32 bits when 
bit 8 of the G designator specifies 32 bit operands. 

The control vector for macro instructions which produce resuk vector fields, performs the same function as in 
a vector instruction. Vector macro instrucfions with result field(s), extend short source fields with zeros; they 
become no-operations, and terminate in an identical manner as a vector instruction. Vector macros with result 
field(s) terminate when either source vector is exhausted; they do not zero extend short source fields. 

Broadcasting both source fields for vector instructions with a result field, produces an undefined condition. 
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SPARSE VECTOR INSTRUCTIONS 

Arithmetic operations can reduce the number elements of a vector field to zero or near-zero value; therefore, 
except for positional significance, they need not be carried along as floating-point numbers. To conserve both 
storage and calculation time, a group of sparse vector instructions which permit the expansion and compression 
of vectors can be used. Similarly, the programmer may wish to eliminate out-of-range data. 

The user can form a sparse vector by generating an order vector through the compare instructions. A vector 
containing non-significant elements can be reduced then to a sparse vector through the (BC) compress instruc- 
tion which uses the generated order vector to remove the non-significant elements. The operation codes for 
the compare and compress instructions are C1-C7. The sparse vector can be restored back to the original vector 
size through MASKV instruction Operation code BB). The format of the sparse vector cannot be distinguished 
from that of any other vector; however, the associated order vector determines the positional significance of 
each vector element. Bits, 5, 6, and 7 of the G field must be set to 0, for all sparse vector instructions except 
those with operation codes: A0-A2, A4-A6, A8, A9, AB, AC, and AF. The paragraph on sign control at the 
end of this appendix explains bits 5, 6, and 7. When these bits are set to a value, all the G field bits must 
be zero. 

Neither indexing nor offsetting is performed by the sparse vector instructions. The field lengths associated with 
source sparse vectors A and B are not used (format 2). These lengths are determined by the number of ones 
in the associated order vector. The field lengths of source order vectors X and Y and the result order vector 
Z (format 2) are item counts in bits. 



SPARSE VECTOR ADD 

This example (12) illustrates a method of producing sparse vectors and the use of the add sparse vector instruc- 
tion. In a sparse vector, extraneous information has been removed; but, the position of its elements remain the 
same through use of an order vector. This example illustrates: 

How to reduce a MATRIX to a sparse vector 

How to create an order vector 

How to write a sparse vector instruction. 

This example also makes use of a broadcast constant. 

CREATING THE MATRIX 

Matrices are created in this example through GEN directives. Since the MATRIX is a group of vectors, it must 
have a descriptor specifying its length and base address; and since the instructions using these descriptors require 
them to be in a register, each descriptor must be equated to a register. Matrices for this example follows: 

Matrix A Matrix B 

Row 1 12 3 4 5 6 7 8 25 11 25 10 23 22 21 20 

2 9 10 11 12 13 14 15 16 19 18 17 12 15 14 13 12 

3 17 18 19 20 21 22 23 24 13 14 15 16 17 18 19 20 
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Matrix C contains only one element, which is broadcast to create the order vector. The order vectors are created by 
the CMPGE instructions. These instructions compare the broadcast constant against each item in matrix A and B. . 
Since the value C is in hexadecimal and the values generated for the matrix were decimal for all integers 
greater than or equal to 12, a 1 will be placed in ail corresponding order vector location. For values less than 
12, a zero will be entered in the order vector.. 

Order Vector for Matrix A 



24 



64 



|0 0000000111111111111 



Order Vector for Matrix B 




24 



64 



1010111111111111 1111111 



The matrix contains full-word values; the order vector contains bit values. 

Now that an order vector is established, the compress (CPSV) vector instruction can be used to create the 
sparse vector. 



Compressed Matrix A 

13 14 15 16 17 18 19 20 

21 22 23 24 ► 



Compressed Matrix B 

25 25 23 22 21 20 19 18 

17 12 15 14 13 12 13 14 

15 16 17 18 19 20 ► 



These matrices, in abbreviated form, are summed and the inclusive OR results of their order vectors are placed 
in a register. The inclusive OR forms the order vector for the resultant sparse vector. The following figure 
provides a functional view of the ADDNS instruction. 
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Result of ADDNS is: 

SPARSE 
VECTOR A 

t 



12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



ORDER VECTOR A 



ETC. 



000000000001111111111111 



'y'Ji'VV'*' 



ETC, 



SPARSE 
VECTOR B 



t 



101011111111111111111111 



\l/^i,^>i/'i/ 



ETC. 



101011111111111111111111 



ADDED TO MACHINE ZERO 



ORDER 

VECTOR 
B 

INCLUSIVE 

OR 
RESULT OF 
ORDER VECT. C 



25 
25 
23 
22 
21 
20 
19 
18 
17 
12 
15 
14 
13 
12 
13 
14 
15 
16 
17 
18 
19 
20 



ETC. 



RESULT 
VECTOR 



25 

25 

23 

22 

21 

20 

19 

18 

17 

12+12 

15+13 

14+14 

13+17 

12+16 

13+17 

14+18 

15+19 

16+20 

17+21 

18+22 

19+23 

20+24 



tlhese values are normalized before the addition occurs and results are in normalized form. 
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EQU *AB'6i. 




iatrk; des:rii 


;t 


aCGuD0Cu2Ai.0 


REG. 9 


ECU #A9^6<. 




RESULT INCLUSI' 


nc 


il3CuOOC028lO 


OBR 


rau *A[ 


•6<. 


•DATA BASI 



OC OaOQOCOOQ5<>0 

3C gGuC(}&a33660 

:c j.cout:co6ca 

3C 3CP000;007i,0 

IJC OCOGguOG07i.O 

DC 3uGGC00ua780 

JC juCu3Q3307CQ 



D2 


CC]303OC!!O0C 


F 






START 


32 


300030300000 


F 


351C0015 






32 


:oaJ30'!:oo20 


M 


9SjCCai5 


3C0Q0C1C 




32 


OP3u:03C006C 


li 


751C0iiO 






32 


300C1 JQOOOBO 


F 


7jieaoic 






02 


OOOiOOOOOCAO 


H 


3Fieoaoo 




• 


32 


ouao-jiooooc 


F 


781EauAC 




• 


32 


000D3':3a''0E0 


H 


2AACa009 






32 


UOO-QCOCCloO 


F 


SEAi:3cr' 


3v0328i.C 




02 


ccod33::cii.o 


F 


2AAi3a:9 






32 


J0O:3C3C016O 


H 


9n:tojAu 


00CJ3CA1 




02 


033C3L3rClAO 


H 


C6je)0Al 


ai!A3Ai..3 


COHPA 


02 


aaoco;3:ciEC 


H 


CbSBOoaa 


0GA3A&'a 


COMPJ 



■:? 3003003:3220 

3 2 a00 0T0aC0 26O 

32 ao3Cj3o;!}2Ai: 

32 aoa:joaco2Eo 

32 030000203300 

02 ^030a0D0Q3<>0 

3? 30000333COOO 



33 goooaoDooaoo f 

33 300030080010 C 

33 oooi;]occ;oi.o f 

33 030000300050 C 
03 030031300080 F 



9COL03A1 0C30AI.A6 

9C3iaaA2 30JuA5A7 

A?OCAiiA& ASA7A9AS 
38100315 

9!3Ca31D Ii030ai!15 
33<.C031A 



0318 

co3cao:c-g2i>3(!)3i 
ooie 

03CC30aa0883(03> 
C3H0J0D OGOJOOlC 



X A DESCRIPTOR 
X B DESCRIPTOR 
X C DESCRIPTOR 
ATRIXA REC 
ATRIXB REG 
RIX A DESCRIPTOR 
RIX 9 DESCRIPTOR 
PTOR REG (RESULT) 
VE OR 0R3ER VECTOR 
E REG 

VITAL EQU fl5»6i. 
RTM EQU flA»6li 

OSP EQU »13»6i» 

CSP EQU #lC*b<. 

PSP EQU »1D»6«. 

CD9 £au flE»6<» 

UNIT EQU AlF^ei. 

LTOL CSP|VITAL 

VTOV VITAL, CSP 

RTOR CSP, PSP 
RTOR OS", CSP 
IS OSP,t 

RTOR C0B,03R 

•••GENERATE 3ESCRIFT0?; IN REGISTERS 

ELEM CBR,9 'tUER LENGTH INTO DATA BASE REGISTER 

EX OEG.l.REG.l 'SET POINTER FOR REG.l 

ELEN PEG. 1,9 •SET POINTER LnGTH 

VTOV aaR, REG.l 'VECT TO VECT TRiS MATRIX LOC TO REGS 

CMPGt..3 REG.l, REG.!, REG. I. •CREATE ORDER VECTOR 

CmPGE.J R"5. 2, REG. 3, REG. 5 'CREATE ORDER VECT 

••COiPRESS TO SPA«E VECTORS'* 

RESJLTl CPSV REG.l, REG. 6, REG. 4 
RESULTS CPSV REG. 2, -(EG. 7, PEG. 5 
ADDITION ADONS (REG.e.REG.w), {REG.7,REG.5>,{REG.8,REG.9> 

LTOL PSP, VITAL 

vrOV PSP, VITAL 

6A0F,SR ,RTN 

"SEC 
••••DESCRIPTOR SETUP 
PRESET F0R■^,6^ 16,1.8 
MATRIXA PPESET FLO.LT, STAPT.A 



1ATRK3 PRESET FLD.LT, ST ART.3 
MATRIXC PRESET 3, START. C 



•DESCRIPTOR FOR HATRIXA 
•DESCRIPTOR FOR MAIRIXB 
•OESCRIPTOP FOR HilRIXC 



1/COOS 

i/ua>i6 
i/caar 

1/G30S 

i/:ou9 

l/cOlu 
l/COll 

i/:oi2 
i/roi3 

1/0011, 
1/L015 
1/G016 

i/bOir 

1/3018 
1/1.019 
1/G02y 
1/C021 
1/0022 
l/lu23 
1/C'CZ<> 

1/.025 

i/:a26 

1/.C27 

i/^^aza 

1/Cb29 

1/{03C 
l/GOSl 
l/v032 
l/i.u33 
1/C03<» 
l/tS3S 
1/-.J36 
1/U037 
1/0038 
1/..D39 
1/13«0 
l/.b<>l 

i/:b<»2 

1/C0<»3 

i/;.ai«<> 

1/lO<,5 
l/CCi,6 
l/uui,7 

i/Cuoa 

1/Cu<i9 
1/. Su 

1/casi 

1/U352 
l/>.353 

l/wOSk 
1/jOS5 
l/CG5b 
l/i.fc5T 

l/GtSI 
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coc ST»? tssE'^aie^ ver i.t 



j3 aooooo::cot5 f 

0! ')oao?a:ccicc f 

13 oojfojrjjiiu c 

OJ aOOOIOKQi'.O F 

j; cai30J(}:':?i50 c 

ai aoocjc^rniso f 

03 flaoooujr'!i9c c 

83 oooeoc3c:icc f 

33 GoaGiaacozo; f 

33 0300000:0210 c 



03 300 
03 930 
03 033 
03 00<] 

a; 000 

03 000 
03 uOO 

a? 300 

33 OOB 
03 100 
33 JOO 
03 000 

03 oca 

33 00» 
33 300 
03 300 
33 000 
33 000 
33 003 
93 300 
33 030 
33 COO 
33 000 
33 030 
33 033 



3313 
033C 
03330 
C3030 
C003u 
a333C 

booi: 
03a:G 

33000 

:ooa: 
oajoo 

0330: 
93D3C 
300DC 
00300 
03033 
03010 
03330 
C303 J 
03300 

003?a 

C0033 
C033J 
03033 

oaoiD 



33 000090? 
33 0000000 
03 0090003 
03 OOOOGOS 
93 3000000 
03 3000300 
03 9003000 
33 9000000 
03 0033333 
03 0O0O0C3 
03 0000003 
33 0030333 
93 0000003 
33 0000300 
03 0000380 



a2<*c 

028C 
C2C0 
030C 
03'. 
33SC 
33CC 
3W00 

0I.S0 
G<>CO 
3500 
05<.0 
0560 
35CC 
O&GC 

C6I.I: 

06S0 
Ci6CC 
0701 
071.1' 
0780 

a7co 

0800 
0SI.0 



93 000033330880 F 
33 aOOC330aO8CO F 
33 0300333C090S F 



009<.0 
00980 
0C9C0 
GOtOO 
0OAI.0 
CCASO 
OG&CQ 
OOBOC 
80BI.0 
0CB80 
SCO 

oscco 

COCI.0 
DOCSQ 

oocco 



C318 

G J jC 3 j ju JtSi OJi 

3918 

OKt J3i.0l7Ei,«33) 

J3;C 

3::ui:;2«c^c33j 

00-r330C2F83(33I 
03:C3j.C 0$:03COO 
OOlf 

03313:Q!,21<.j(33I 
•A 3::uOC.<33ClS 



3 J n j 3 . : 
0J.c:3cc' 

03:C33:u 

g::c3u^c 
0'::c30jo 
oj:c3a:s 

00JCQCO3 
C3;C33jO 

a;;t3jjC 
ojcc J3:o 
. c 3 j ; 3 
030C333C 

oa3C3a:c 

Q0:C33JC 
003t33CO 
033CS3JC 

on:c33;c 
33;r3a.c 

303r3J..C 
33gC3G Jt 
330t30j0 

o:cc3Jc: 
oo:c33:c 

C3Qt93;0 
OOiGSGuC 



:0333GC1 
00030012 
203j3CC J 
OGOOOOC 
30033CC<« 
3C333ub; 
0C033C:6 
3C}03007 
30v 33CC 8 
00333009 
3C:33uCA 
00-30Ci.3 
00303CIC 
OCOOOOCO 
OOOOOCCE 
3uJ33:CF 
OCJOOCIO 

:o:'SOCii 

03J33C12 
30333013 
00330014 
00030015 
00C3vlCl& 
30303017 
30333018 



ooaroioo co30oci9 
a3:c3Cv.c 3c:3J0^9 

03;t33j0 00300019 



OOOCGCCC 
03003330 
330C33.3 
003C33>.u 
3C:C093C 
Q03C33:3 
03303333 
80300300 

ca:cu30G 

OOOCOJi^O 
003CO30O 
3i::C3330 
00Cl33u3 

3 ; c 

033C000C 



3C003C0* 
00003017 
00033C16 
00033015 
0CJ3801<. 
OOGOOClS 
30333012 
0C330C11 

acoooccc 
oooaaooF 

3G0aO0C£ 

oooaoocc 

u00333CC 
30033003 
OCOOObCE 



SB4^S£ KECTJI »00 0»Tei 18ABR73 

0_VE:r P^LSET Fi.0.l.T,3?li».Vi:T 'C^OER VECTO-l FCR laTRiX* 

a2.Vi:r preset FL3.Lr,0iDE<.VECT2 •QftDE'* VECTOK 1AT»IXB 

SP«R;1 PetSET FL0.LT/2,REiULr» •OESCRIPTOK F0< SPARSE* 

iPA^H P^iSET FL0.LT/2,RfSJl.r3 •0£5CRIPrO«< FOR SPARSEJ 

SPAR?: PPESET FL0.LT/2,RESU..rc •DESCRIPTOR FOR SPARSEC 

03 <li'T PRESET FlD.LT ,0RaER.V£CT3 'OROiR WECT RESULT 



PACE 



FLO.LT EQJ 2<. 

••SEMERATF fATRICIES*** 
START.A gen 1,2>3.'.,<..5.6«7,4 



•FIELO.LENGTrt FOR ALL HATRICIES 
•ROMI^IATRIXA 



3 

1/CG63 

t/C361 

1/0362 

1/0363 

1/006'. 
1/1^965 

1/0066 
1/0067 
1/C068 



GEN 9.1^tlt«12tl3fl<i>l5,16 •R0«-1ATRIXA 



GEN 17,t6il9t'0t21f22t23t2<. •R0H3-HATRIXA 



START.! GEN 25. Ili25 ilO , 23,22 ,21,23 •R0m-1»TRIX3 



GEN 19tl6,17,l2,15,l<<,t3,12 *R0H2-i1tTRIX3 



GEN 13, II., IS, 16, 17, IS, 19, 23 •R0U3-MATRIX3 



1/3C71 
1/.072 



COC STAR ASSEHBLER 

93 000030000000 F 

33 0O0C303COO<t0 F 

33 d003J0300D8C F 

33 9O003aJ00OC3 F 

03 aOOOOCOOOEOQ F 

33 OOOOOOOOOEWO F 

■13 0O0a3930CE80 
33 0O3C300017E0 
33 aoa03Q3';21'»0 
33 iO3C0a302ACO 

2F80 



I 


VER 1.; 


r 




OJ 


i:C033C 


30! 


i33CCF 


33300000 


oo; 


333010 


3J 


i:c33;o 


OOi 


:33011 


o; 


■; 1 : 


00 


333012 


u33T3gjO 


30. 


.33013 


o: 


! 3 3 : c 


3^i 


COOOli. 



SPARSE VECnt ADO 



OATEI 18APR73 PAGE 



uC OJCOOOOOilCOC 



START.: tOU #C 
OROER.ViCT RES i6<.»2<. 

OR0ER.VECT2 RES #6'.*2'. 

OROER.tfiCTS RES #6'.»2<. 

RESULT* RES, 6-. «6'.*1.' 

RESULTS RES,6<. ifcit'i: 

ENO START 



•RESERVE FOR 14TRIX.A O.VECTOR 
•RESERVE FOR lATRlX.B O.VECTOR 



l/aC75 
1/.&76 
1/0 3 77 
1/0078 
1/0079 
1/C0S3 
1/0381 
1/CGS2 
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CDC ST«lt «SSeHSLE<t VER t.T 



NUM9EP OF HAliNINC HESStCES ■ 
NUrtSER OF ERROR KESSACES ■ 



SPARSE VECTOR too 



OtTEl leAPRrS PI6E 



CDC STAR ASSEHBLER VER 1.7 



OATEi I»APR7S PACE 



1/L0S3 



ASSEHBLY FINISHED 
3l(t0 A.H, HEONESOAT ISTH. APRIL» 1973. 
NJMBER OF STATEhENTS PROCESSED 156 
NJHBER OF HARNING MESSAGES NONE 
NJK3ER OF E^ROR HESSAGES NONE 



STAR LOAOER Vt.l 



SlltZ A.N. MEONESIAY ISTH. APRlLi 1973. 



START 

TOTAL ELAPSED TIHE FOR THIS LOAD HAS k SECONDS. 

1 PAGE (5) OF DATA MERE ALLOCATED. 

1 HODULES DEFINING 1 SYMBOLS HERE LOAOEO. 





PLA I 




a3li>0l0<>.29S 


ia/3i>/73 


:ooE 


IJ300310: 


iooao 


0DC380 




DATA 


0;C0013( 


:a3ao 


()03i>wa 




ENTRY 


ojcuotc; 


;d()go 







*•* OUHP OF VIRTUAL MEMORY FROM ADDRESS IJOaOSOCaOl) TO 3009OSDeO3a<' 

OUTPUT 



FFO&6«30 ODOtDOai 

FFO65330 C30C00J) 

FF05&30D CC'LuOOn 

ffod6:30 accGOO)] 

FF07<>63C ajjiaon 

FFD75630 3C0CQ0)) 

caoaci:30 ooooaon 



JOOgOSOODDDO 


FFO66<i0C 


O^COOOJG 


300005000100 


FF065i.at 


03000030 


000005003300 


FFOftititOl 


OutOOCliO 


000005000300 


FFD66C0Q 


OOoOCQCO 


3033a5D00<>30 


FFD?tt23C 


OuCOOCOO 


000305000600 


FFD?5Z0t 


Ou&OOCDG 


0C30a5030630 


00u3333C 


33000000 


••• RPT. •»• 






300005009000 


00030330 


30C01F1C 


003305000100 


303333Ct 


33000030 


*•• i^pT, **• 






300005010900 


00003000 


OODOIFIC 


000005010100 


OOOOOSOF 


00000000 


••• RPT. •»• 






000005018000 


0300D33C 


OOOOIFIC 


000005016100 


0003000C 


30000030 


••• RPT. ••• 






000005020300 


0003000C 


OOOOIFIC 



10030300 30CCa33) 
t00J03u0 3700003] 



OOOOOOOD 3000001} 
EOOQOOOO OOOOOOIJ 



(0000300 03300031 
C0030330 300G0031 



FF055COO 


0930; 


.030 


FF365800 


00000030 


FF06^CO; 


ciijc: 


003 


FF36<.eaa 


03000039 


FF066COi; 


u3J0- 


:d3d 


FF366C00 


00000003 


FFa67<.03 


u03D' 


000 


FF167CC0 


03000030 


FFDri««&0 


C03c: 


;030 


FFD7I.E00 


ClOOCOOO 


OOOOJI^SO 


uD33- 


fBOO 


3)103000 


b3DaC333 


CCU00303 


co3o: 


!000 


OllOCOCO 


ooocor30 


u03o:coj 


Q03D- 


;Dao 


33 IJODDQ 


C<i03uD30 


30^03000 


00331 


:03C 


33100CC(i 


OuOOODDO 


00333000 


CD30: 


:oo3 


31130000 


bOOOOCSO 


00300000 


oooo; 


)flao 


OllD&OCb 


buObOCJO 



00030000 0030:000 
3C303C30 0330:000 



33 I3G0CO uOOOOCOD 
J3 13C00O 00000030 



00030330 030000)1 30000303 OOQS'.OOO OllOOOCO 03000030 



END OF VIRTUAL MEMORY DUMP 
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STRING INSTRUCTIONS 

String instructions perform arithmetic and logical operations on strings of data in the form of 8-bit bytes. 
The byte size allows for handling large alphabets (256 characters) and is compatible with ASCII extended 
binary code. The field length of a data string can be extended beyond one 64-bit word or can be less than 
one data word. Bytes in the field of a data string are in opposite order of the byte address; the most signifi- 
cant byte is the leftmost byte, but, the address of the leftmost byte is 0. 

Unless specified by the instruction, strings are processed from right to left until the last byte in the field is 
processed. Normally, string instructions terminate when the result field is filled. 

String instructions perform operations on data strings in packed binary -coded decimal (BCD) form, zoned 
BCD, and binary formats. The zoned-decimal format is used for I/O operations. Each byte, with exception 
of the rightmost byte, contains a BCD digit with a zone designator (3) located in the leftmost 4 bits of each 
byte. The rightmost byte contains the sign in the leftmost 4 bits. (A for +, B for -.) 



4 
bits 



4 
bits 



ZONE DIGIT 



ZONE DIGIT 



SIGN DIGIT 



Byte 



Byte 1 

ZONED BCD 



/ 

Byte 2 



The packed decimal form normally is used for arithmetic operations. The rightmost 4 bits of the rightmost 
byte contain the sign, the remaining bytes consist of two 4-bit digits. 




PACKED BCD 



Binary numbers are represented in strings of 8-bit bytes. The leftmost bit of the leftmost byte contains a sign 
(0 for +) (1 for -). All binary numbers are sign extended through the sign bit. All negative numbers are two's 
complement. 

String instructions make use of string indexes, which are item counts in bytes, for all instructions with the 
exception of D6 and FF. A string index can have a value of up to l^^'^ . The leftmost 3 bits of a string index 
are not used, the sign of a negative index is extended through bit 16, and overflow is not detected when an 
index is added to a base address. 



I 
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DELIMITERS 

There are six string instructions which permit deUmiter termination: these are F8, F9, FD, EE, EF, and D7. 
All other string instructions have length limited fields. Dehmiters are contained in bits through 15 of a 
designated register. When a character in the data field locafion matches the delimiter value, the instruction 
terminates. Field length or deHmiter character is selected by G designator bits. 



Bits 

d (8 and 9) 
e (10 and 11) 
(12 and 14) 
(is'and 15) 



Designator for A and B 

Designator for C 

Undefined O's 

Increment A field and C field index respectively 



Table C-5. String Instruction G Designators 



Designator 


d/e Bit 
Value 


Function 


d and/or e 
d and/or e 
d and /or e 
d 


00 
10 
11 
01 


The 16-bit length specification in A, B, and/or C represents an item 
count of the number of bytes or bits in the field (field length). 

The rightmost 8 bits of the length specification in A, B, and /or C are 
used as a delimiter character. 

The entire 16 bits of the length specification in A, B, and/or C are 
used as a delimiter character. 

The rightmost 8 bits of the length specification function as a delimiter 
character. The leftmost 8 bits serve as a mask on the comparison. 
Bits in the delimiter character and the operand byte are compared 
only where I's exist in the mask. This specificafion applies only to 
source fields. Any instruction becomes undefined if this specification 
is used for a result field. 



INCREMENTS 

Nine instructions use index incrementing: F8, F9, FD, FE, D6, D7,EE, EF, and FF. At the termination of these 
instructions, the index register fields are left in one of the following states: 

No Increment - The index register remains at its original value. An example is the index register associated 
with a translate table. Characters to be translated are added to the indexed address of the table to obtain 
the translated character. The index associated with the table does not change during the instruction 
execution. 
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Partial Increment - The index register is incremented to specify a particular character or word in its 
associated field. An example is the FD instruction which searches two byte strings for inequality. When 
an inequality is found, the search terminates and a count equal to the number of no-hit comparison is 
added to each index. The end may not have reached field lengths, but the location of the unequal char- 
acters can be formed by manipulating the incremented index and the base address. 

Full Increment - The index register is incremerited by the full length of its associated field. For example, 
when the translate instruction is terminated, the index associated with source field A is incremented by 
the length of field A to specify the starting bit of the next contiguous field. If field length is specified by 
a deUmiter character, the field is searched for that character. The index of the associated field is 
incremented then so the starting point is one character beyond the delimiter characters. 

LOGICAL STRING INSTRUCTIONS 

These instructions function in the same general manner as corresponding string instructions. They operate with 
index and data fields the same as for string instructions except item counts are expressed in bits instead of 
bytes; therefore, these instructions perform bit operations on bit boundaries. 

MONITOR INSTRUCTIONS 

The monitor instructions function only during monitor mode. When a machine is in job mode, any attempt 
to execute a monitor instruction is detected by the hardware as an attempt to perform an undefined function 
code. 



NON-TYPICAL INSTRUCTIONS 

These instructions perform operations such as register to storage transfers; formation of repeated mask lists; 
and maximum/minimum determinations that do not belong in any of the preceding instruction types discussed. 

SIGN CONTROL 

Certain vector, sparse vector, and non-typical instructions provide an operation called sign control on the- input 
operands. (Table C-6.) For these instructions, bits 5, 6, and 7 of the G field have the following significance. 



Use the operands from the A stream in the normal manner. 

Complement the coefficients of the operands from the A stream before using them. 

Use the magnitude of the coefficients of the operands from the A stream. 

Make all positive coefficients of the operands from the A stream negative before 
using them. Negative operands will not be altered. 



Use the operands from the B stream in the normal manner. 

Use the magnitude of the coefficients of the operands from the B stream. 
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Bit 5 


Bit 6 











1 


1 





1 


1 


Bit 7 







Use t: 


1 


Use t: 



Any complementing necessary to achieve the required operand state is a 48-bit two's complement operation 
performed before operands are used in the specified arithmetic operation. If the complement of the coefficient 
2000 0000 0000 is required, the operand will be used as 7000 0000 0000 with one added to its exponent, 
which could cause exponent overflow. 

Any significance calculation necessary in performing an instruction is made before complementing occurs. 



Table C-6. Instructions with Sign Control 



Instruction 




A Operands 
Bit 5 and Bit 6 


B Operands 
(Bit 7) 


80, 81, 82 


Vector Add 


X X 


X 


84, 85, 86 


Vector Subtract 


X X 


X 


88, 89, 8B 


Vector Multiply 


X X 


X 


8C, 8F 


Vector Divide 


X X 


X 


93 


Vector Square Root 


X X 





AO, Al, A2 


Sparse Vector Add 


X X 


X 


A4, A5, A6 


Sparse Vector Subtract 


X X 


X 


A8, A9, AB 


Sparse Vector Multiply 


X X 


X 


AC, AF 


Sparse Vector Divide 


X X 


X 


CF 


Arithmetic Compress 


X X 


X 


D8 


Maximum of A to C 


X 





D9 


Minimum of A to C 


X 





X or 1 bit is legal 

This bit must always be set to zero 



MACHINE INSTRUCTIONS 

Tables C-7 through C-17 list all of the machine instructions available with the Control Data STAR computer 
system. They include: 

Instruction OP Code 
Format (F) 
Instruction Mnemonic 
Applicable Operands 
Applicable Qualifiers 

Register designators contained in the operand portion of the table are defined in table C-17. 
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00 

o 
to 
o 
o 

w 



Op 



3E 
4D 
BE 
CD 
3F 
4E 
BF 
CE 
38 



6 
6 

5 
5 
6 
6 
5 
5 
A 



Mnemonic 



ES 

ESH 

EX 

EXH 

IS 

ISH 

IX 

IXH 

LTOL 



Qualifiers 



none 



Table C-7. Index Instructions 



Operands 



none 



Rf,I16 
Rh,I16 
Rf,I48 
RhJ24 
Rf,I16 

RhJ16 
Rf,I48 
Rh,I24 



Description 



Enter short, full word: I16-> R15.53, R.J., SE;0^ Rq.is 

Enter short, half-word: 116 ^ ^8-31' R-J-' S E; -> RQ.y 

Enter index, full word: 148 -> Rj 5.53, -> Rq-IS 

Enter index, half-word: 124 -^Rg-Si , -> Rq.j 

Increase short, full word: Ri6-63 + 116 ^ Ri6-63' Ro-15 unchanged 

Increase short, half-word: 116 + Rg-Si ^ R8-31' Ro-7 unchanged 

Increase index, full word: 148 + R -> R 

Increase index, half-word: 124 + R -> R 

Transmit length Rq.is to length T0.15, T16.53 unchanged 



n 

to 



o 

to 

00 



Table C-8. Register Instructions 



Op 



Mnemonic 



C» 
O 
NJ 

O 

o 



79 

59 

61 

2B 

41 

62 

42 

60 

40 

63 

75 

55 

74 

54 

11 

72 

52 

76 



A 
A 

4 

4 

4 

4 

4 

4 

4 

4 

4 

4 

4 

4 

A 

A 

A 

A 



ABS 

ABSH 

ADDL 

ADDLEN 

ADDLH 

ADDN 

ADDNH 

ADDU 

ADDUH 

ADDX 

ADJE 

ADJEH 

ADJS 

ADJSH 

BTOD 

CLG 

CLGH 

CON 



Qualifiers 



none 



Operands 



none 



Rh'Th 
Rf,Sf,Tf 

RL,Sf,TL 
I^h'Sh'Th 
Rf,Sf,Tf 

Rh'Sh'Th 
Rf,Sf,Tf 

Rh'Sh'Th 

Rf,Sf,Tf 

Rf,Sf,Tf 

Rh^h'Th 
Rf,Sf,Tf 

^h'Sh'Th 

Rf.Tf 

Rf.Tf 

Rh'Th 
Rf.Th 



Description 



Absolute, full word F P: ABS(Rf) -> Tf 
Absolute, half-word F P: ABS(Rh) -> T^ 
Add lower, full word F P: (Rf) + (Sf))L^ Tf 

Add to length: Rq.is + S40.63 "^ ^0.15' ^16-63 ^^16-63 

Add lower, half-word F P: ((R^) + (Sh))L-^ T^ 

Add normaUzed, full word F P: ((Rf) + (Sf))n -> Tf 

Add normalized, half-word F P: ((R^) + (Sh))n ^ T^ 

Add upper, full word F P: ((Rf) + (Sf))^ -> Tf 

Add upper, half-word F P: ((Rj^) + (Sh))u ^ T^ 

Add index (address), full word: Ri6-63 + ^16-63 ^ Ti6.63,R0-15 "^ ^0.15 

Adjust exponent, full word F P: (Rf) per S -> Tf 

Adjust exponent, half-word F P: (R^) per S ^ T^ 

Adjust significance (shift), full word F P: (Rf) per S -* Tf 

Adjust significance (shift), half-word F P: (R^) per S -> Th 

Convert binary R to packed BCD T, fixed length 

Ceiling, full word F P: nearest integer .GE. (Rf) -^ Tf 

Ceiling, half-word F P: nearest integer .GE. (R^) ^ T^ 

Contract, full word F P: R64 -* T32 



\D 
00 

o 

o 
o 



o 

M3 













Table C-8. Register Instructions (Cont'd) 


Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


6F 


4 


DIVS 


no 


ne 


Rf,Sf,Tf 


Divide significant, full word F P: ((Rf)/(Sf))s -> Tf 


4F 


4 


DIVSH 






Rh'Sh.Th 


Divide significant, half-word F P: ((Rh)/(Sh))s ^ T^ 


6C 


4 


DIVU 






Rf,Sf,Tf 


Divide upper, full word F P: ((Rf)/(Sf))u -^ T^ 


4C 


4 


DIVUH 






Rh.ShJh 


Divide upper, half word F P: ((Rh)/(Sh))u "^ ^h 


10 


A 


DTOB 






%Tf 


Convert packed BCD to binary T fixed length 


2A. 


6 


ELEN 






Rl,I16 


Enter length: 116 -> Rq-IS, Rl6-63 unchanged 


7A 


A 


EXP 






R^Tf 


Exponent, full word: Rq-IS "^ ^15.53, S E, -> T0.15 


5A 


A 


EXPH 






RLh'Th 


Exponent, half-word: R0.7 -* T8.31, S E, ^ T0.7 


6E 


4 


EXTB 






Rf,Sd,Tf 


Extract bits from Rf to Tf per S^j 


5C 


A 


EXTH 






Rh'Tf 


Extend half-word F P: R32 -> T^^ 


5D 


A 


EXTXH 






Rh'Tf 


Extend index, half-word F P: R8.31 -> Ti6.53,S E, R0.7 -> To.i5,S E 


71 


A 


FLR 






Rf.Tf 


Floor, full word F P: nearest integer LE. (Rf) -> Tf 


51 


A 


FLRH 






Rh'Th 


Floor, half-word F P: nearest integer .LE. (R^) ^ T^ 


6D 


4 


INSB 






Rf'Sd,Tf 


Insert bits from Rf to Tf per S^ 


7C 


A 


LTOR 






RL^Tf 


Length to register, full word F P: Rq-IS "^ ^43.53, -^ T0.47 


69 


4 


MPYL 






Rf,Sf,Tf 


Multiply lower, full word F P: ((Rf)*(Sf))L "^ Tf 


49 


4 


MPYLH 






Rh'Sh.Th 


Multiply lower, half-word F P: ((Rh)*(Sh))L ^ T^ 


6B 


4 


MPYS 






Rf,Sf,Tf 


Multiply significant, full word F P: ((Rf)*(Sf))s ^ Tf 


4B 


4 


MPYSH 






Rh'Sh.Th 


Multiply significant, half-word F P: ((Rh)*(Sh))s ^ T^ 


68 


4 


MPYU 


no 


ne 


Rf,Sf,Tf 


Multiply upper, full word F P: ((Rf)*(Sf))u -> Tf 



n 
o 



Table C-8. Register Instructions (Cont'd) 



Op 



Mnemonic 



Qualifiers 



Operands 



Description 



oo 

O 

to 

o 
o 

ex) 



48 
7B 
5B 
2D 

77 

2E 

78 

58 

2C 

34 

30 

73 

53 

65 

45 

66 

46 

64 

44 

67 

7D 

70 

50 



4 
4 
4 
4 
A 

A 
A 

4 
4 
7 
A 
A 
4 
4 
4 
4 
4 
4 
4 

A 
A 



MPYUH 

PACK 

PACKH 

RAND 

RCON 

RIOR 

RTOR 

RTORH 

RXOR 

SHIFT 

SHIFTI 

SQRT 

SQRTH 

SUBL 

SUBLH 

SUBN 

SUBNH 

SUBU 

SUBUH 

SUBX 

SWAP 

TRU 

TRUH 



none 



none 



^h'Sh'Th 
Rf,Sf,Tf 

Rh'Sh'Th 

Rf,Sf,Tf 

Rf'Th 

Rf,Sf,Tf 

Rf^Tf 

Rh'Th 
Rf,Sf,Tf 

Rf'IS'Tf 

Rf>Tf 

Rh'Th 

Rf,Sf,Tf 

Rh>Sh,Th 

Rf,Sf,Tf 

Rh'Sh'Th 

Rf,Sf,Tf 

Rh'Sh'Th 

Rf,Sf,Tf 

Rd'Sf.Td 

Rf'Tf 

Rh^Th 



R: exponent 
S: coefficient 



Multiply upper, half-word F P: ((Rh)*(Sh))u ^ ^h 

Pack, full word F P: R48-63 ^ '^16-63 "^ ^f 

Pack, half-word F P: R24-31 & ^8.31 -^ Tj^ 

Logical AND R,S, to T 

Rounded contract, full word F P: R54 -* T32 

Logical inclusive OR R, S, to T 

Register to register full word transmit: (Rf) -^ Tf 

Register to register half-word transmit: (Rj^) -» Tj^ 

Logical exclusive OR R, S, to T 

Shift Rf by (Sf) to Tf 

Shift Rf by Ig to Tf 

Significant square root, full word F P: SQRT(Rf)s -* Tf 

Significant square root, half-word, F P: SQRT(Rj^)s -^ Tj^ 

Subtract lower, full word F P: ((Rf) - (Sf))L "^ Tf 

Subtract lower, half-word F P: ((R^) - (Sh))L "^ Tf 

Subtract normalized, full word F P: ((Rf) - (Sf))n "*■ Tf 

Subtract normalized, half-word F P: ((Rh) - (\))n "^ ^f 

Subtract upper, full word F P: ((Rf) - (Sf))^ -> Tf 

Subtract upper, half-word F P: ((Rj^) - (Sh))u ^ T^ 

Subtract index (address): Ri6-63- ^15.53 ->Ti5.63,Ro.i5 "^Tq-is 

Swap registers start with Sf, storing at T^ and loading from R^ 

Truncate, full word F P: nearest integer .LE. (Rf) -^ Tf 

Truncate, half-word F P: nearest integer .LE. (R^) -^ T^ 



Table C-9. Branch Instructions 



VO 
00 

o 

o 
o 

CO 



Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


32 


9 


BAB 


BR,BRO,BRZ, 

T,SO,SZ, 

BRB,BRF 


Sa»Ta 


Branch and alter bit: (S^) is bit to be altered, (T^) is branch address 
qualifiers BRB & BRF branch address is relative ± I half-words 


with 


33 


B 


BADF 


BR,BRO,BRZ, 
SO,SZ,T, 
BRB, BRF 


I6,Ta 


Data flag register bit branch and alter: 16 is bit altered (T^) is branch address 


2F 


9 


BARB 


BR,BRO,BRZ 
T,SO,SZ 


T,S 


Branch to [S] on condition of bit 63 of-register T 




24 


8 


BEQ ' 


no 


ne 


Rf>Sf,Ta 


Branch to (Ta) if (Rf) .EQ. (Sf), full word F P compare 




26 


8 


BGE 






Rf,Sf,Ta 


Branch to (T^) if (Rf) .GE. (Sf), full word F P compare 




20 


8 


BHEQ 




j 




Branch to (T^) if (Rh) .EQ. (Sj^), half-word F P 




■ 22 
23 


8 
8t 


BHGE 
BHLT 






^h'Sh'Ta 


Branch to (T^) if (R^) .GE. (S^), half-word F P compare 
Branch to (T^) if (Rh) -LT. (S^), half-word F P compare 




21 


8' 


BHNE 




1 




Branch to (T^) if (Rh) -NE. (Sh), half-word F P compare 




B6 


■ 5 


BIM 






RiJ48 


Branch immediate to (Rj) + 148 




27 


8, 


BLT 




iS 


Rf.Sf,Ta 


Branch to (T^) if (Rf) .LT. (Sf), full word F P compare 




25 


8 


BNE 


no 


ne 


Rf'SfJa 


Branch to (T^) if (Rf) .NE. (Sf), full word F P compare 





o 



o 













Table C-9. Branch Instructions (Cont'd) 


Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


36 


7 


BSAVE 


none 


Rf'[Ta,Si] 


Branch & save: set (Rf) to next instruction address, branch to [T^ + Sj] 


35 


7 


DBNZ 






Rf,[Ta,Si] 


Decrement & branch non-zero: (Rf)-1 ^ (Rf) if (Rfh^O 
branch to [Tg + SJ 


09 


4 


EXIT 






none 
Sa,Ta 


Exit force, job to monitor 

Exit force, monitor to job, (S^) register file, (T^) invisible pkg 


31 


7 


IBNZ 


'f 




Rf,[Ta.Si] 


Increment & branch non-zero: (Rf) +1 -^ (Rf), if (Rf)f branch to 
[Ta^Sil 


BO 


C 


IBXEQ 


BAB,BRF \ 






B2 
B5 


C 

c 


IBXGE 
IBXGT 






Xf,Af,[Ba,Yi], 

Zf,Cf 


Increment & branch index: Ai6-63 + ^16-63 -^^16.63, Aq.is-^Cq.is 
if Ai6-63 + X16.63 -OP- Zi^^^S branch to (B^) + (Yj), 


B4 


c 


IBXLE 




I 




or relative from the current location ±116 


B3 


c 


IBXLT 






Xf,Af,I16,Zf,Cf 




Bl 


c 


IBXNE 




/ 






3B 


A 


LSDFR 


T 

none 


Rf.Tf 


Load & store data flag register: (DFR) ^ Tf, (Rf) -> DFR 



C» 
O 

to 

o 
o 

t3d 



Table C-10. Vector Instructions 



vo 

CO 

o 
to 
o 
o 

CO 



Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


99 




ABSV 


A,H,0,Z 


[APi] ,C,Z 


Absolute vector: ABS(A) -> C 




81 




ADDLV 


A,B,C,H,MA, 
MB,N,0,Z 


[A,X],[B,Y],C,Z 


Add lower vector: (A + B)l-^ C 




82 




ADDNV 


A,B,C,HMA, 
MB,N,0,Z 


[A,X],[B,Y],C,Z 


Add normalized vector: (A + B)^ -> C 




80 




ADDUV 


A,B,C,H,MA, 
MB,N,0,Z 


[A^],[B,Y],C,Z 


Add upper vector: (A + B)^ -> C 




83 




ADDXV 


A,B,0,Z 


[A,X],[B,Y],C,Z 


Add index vector: Aj^.^g + Bi6-63 "^ ^15.63. Aq-IS 


-^Co.15 


94 




ADJSV 


A,B,H,0,Z 


[A,X],[B,Y],C,Z 


Adjust significance vector: A per B -> C 




95 




ADJEV 


A,B,H,0/ 


[A^],[B,Y],C,Z 


Adjust exponent vector: A per B ^ C 




92 




CLGV 


A,H,0,Z 


[A^] ,C,Z 


Ceiling vector: nearest integer ,GE. A ^ C 




96 




CONV 


A,0,Z 


[a;c],c,z 


Contract vector: Ag4 -* C32 




8C 




DIVUV 


A,B,C,H,MA, 
MB,N,0,Z 


[A,X],[B,Y|,C,Z 


Divide upper vector: (A/B)^ -^ C 




8F 




DIVSV 


A,B,C,H,MA, 
MB,N,0,Z 


[A,X],[B,Y],C,Z 


Divide significant vector: (A/B)^ -^ C 




9A 




EXPV 


A,H,0,Z 


[A^c] ,c;i 


Exponent vector: Aq.js -> C43.53, S E, ^ Cq-IS 




9C 




EXTV 


A,0,Z 


[A,X] ,C,Z 


Extend vector: A32 -^ C54 


■ 



o 



n 



Table C-10. Vector Instructions (Cont'd) 



oo 
o 

o 
o 

CO 



Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


91 




FLRV 


A,H,0,Z 


[A,X] ,C,Z 


Floor vector: nearest integer .LE. A ^ C 


89 




MPYLV 


A,B,MAJ^B, 
N,0,Z 


[a;c],[b,y],c^ 


Multiply lower vector: (A*B)l-> C 


8B 




MPYSV 


A,BJVIA,MB, 
N,0,Z 


[A^],[B,Y],C,Z 


Multiply significant vector: (A*B)5 -^ C 


88 




MPYUV 


A,B,MA,MB, 
N,0,Z 


[A,X],[B,Y],C,Z 


Multiply upper vector: (A*B)y -^ C 


9B 




PACKV 


A,B,H,0,Z 


[A,X],[B,Y],C,Z 


Pack vector: A48.53 & BJ5.53 -> C A:exponent, B:coefficient 


97 




RCONV 


A,0,Z 


[A,X],C,Z 


Rounded contract vector: A54 rounded ^ ^32 


93 




SQRTV 


A,C,H,MA,0,Z 


[A,X] ,C,Z 


Significant square root vector: SQRT(A)g -^ C 


85 




SUBLV 


A,B,MA,MB, 
N,0,Z 


[A,X],[B,Y],C,Z 


Subtract lower vector: (A - B)l -^ C 


86 




SUBNV 


A,B,MA,MB, 
N,0,Z 


[A^] ,[B,Y] ,C,Z 


Subtract normalized vector: (A - B)j^ -^ C 


84 




SUBUV 


A,B,MA,MB, 
N,0,Z 


[A,X],[B,Y],C,Z 


Subtract upper vector: (A - B)^ -> C 


87 




SUBXV 


A,B,0,Z 


[A,X],[B,Y],C7 


Subtract index vector: A16.63 - Bj6.63 ^ ^16-63' 
^0-15-^^0.15 


90 




TRUV 


A,H,0,Z 


[A^] ,C7 


Truncate vector: nearest integer .LE. (A) -^ C 


98 




VTOV 


A,H,0,Z 


[A,X],C^ 


Vector to vector transmit: A -> C 



Table C-1 1. Sparse Vector Instructions 



OO 
O 

to 

o 
o 

CO 



Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


Al 


2 


ADDLS \ 


\ 




Add lower sparse vector : (A + B)l ^ C 


A2 


2 


ADDNS I 


\ 




Add normalized sparse vector: (A + B)j^ -> C 


AO 


2 


ADDUS 


1 




Add upper sparse vector: (A + B)^ -^ C 


AF 


2 


DIVSS 


1 




Divide significant sparse vector: (A/B)s -> C 


AC 

A9 
AB 


2 
2 

2 


DIVUS 

MPYLS / 
MPYSS I 


C,H,MA, \ 
MB,N / 


[Aa,Xo],[Ba,Yo],[Ca,Zo] 


Divide upper sparse vector: (A/B)y -^ C 
Multiply lower sparse vector: (A*B)l-^ C 
Multiply significant sparse vector: (A*B)g -> C 


A8 


2 


MPYUS I 






Multiply upper sparse vector: (A*B)y ->• C 


A5 


2 


SUBLS 1 






Subtract lower sparse vector: (A - B)l-^ C 


A6 


2 


SUBNS / 


i 




Subtract normalized sparse vector: (A - B)^ -^ C 


A4 


2 


SUBUS / 


/ 




Subtract upper sparse vector: (A - B)^ -^ C 



o 



n 



Table C-12. Vector Macro Instructions 



so 
so 

CX) 

o 
to 

o 

o 



Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


Dl 




ADJMEAN 


H,0,Z 


[a;k] ,c,z 


Adjacent mean: (Aj^+j + Aj^)/2 -» Cj^ 




DO 




AVG 


A,B,H,0^ 


[a;k],[b,y],c,z 


Vector average: (A^ + B^)/2 -^ C^ 




D4 




AVGD 


A,B,H,0,Z 


[A,X],[B,Y],C,Z 


Vector average difference: (Aj^ - Bj^)/2 -> Cj^ 




D5 




DELTA 


H,0,Z 


[a;k],c7 


Vector delta: (A^+i - A^) ^ C^ 




DC 




DOTV 


A,B,H,Z 


[A^],[B,Y],Cf_h,Z 


Dot product vector: A-B -^ C, C+1 




DF 




INTERVAL 


H,0,Z 


Af_h,Bf.h,C,Z 


Interval vector: A + (n-l)*B -> C 




DE 




POLYEVAL 


A,H,0,Z 


[A,X],[B,Y],C7 


Polynomial evaluation: Aj^ per B ^ Cj^ 




DB 




PRODUCT 


H,Z 


[A^] ,Cf.h,Z 


Vector product: tt A -> C 




CO 




SELEQ \ 


\ 








C2 




SELGE / 


A,B,H,Z ) 


[A,X],[B,Y],Cf,Z 


Vector select: if A^ -OP. Bjj 




C3 




SELLT \ 






Count up to the condition met -> C 




CI 




SELNE / 


/ 








DA 




SUM 


h;z 


[A,X],Cf_h,Z 


Vector sum: 2 A ^ C, C+1 




B8 




VREW 


H,0,Z 


[A^],C^ 


Transmit vector reversed to vector: Aj-gy "^ C 




B7 




VTOVX 


B,H 


[A^],[B,Y],Ca 


Transmit vector to vector, destination indexed: 
indexed by A 


B->C 


BA 




VXTOV 


A,H,0^ 


[A^] ,Ba,C,Z 


Transmit vector, source indexed to vector: 
B indexed by A ^ C 





Table C-13. String Instructions 



00 

o 
^o 
o 
o 



Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


EO 


3 


ADDB 


none 


[a;k],[b,y],[c,z] 


Add binary: A+B^C 


E4 


3 


ADDD 






[A,X],[B,Y],[C,Z] 


Add decimal: A+B^C 


EC 


3 


ADDMOD 






[A,X],[C,Y],[C,Z],I8 


Add modulo bytes: (Aj^ + B„) mod(I8) -> C^ 


E8 
E9 


3 
3 


CMPB 
CMPD 


1 


1 


[A,X],[B,Y] 


DFB 53 operands equal 
Compare binary (decimal) set data flags: DFB 54 1st operand high 

DFB 55 1st operand low 


E3 


3 


DIVB 






[A,X],[B,Y],[C,Z] 


Divide binary: A/B^C 


E7 


3 


DIVD 


no 


ne 


[A,X],[B,Y],[C,Z] 


Divide decimal: A/B -> C 


PC 


3 


DTOZ 


NS,SS 


[A,X],[C,Z] 


Unpack BCD to zoned: A -> C 


EB 


3 


EMARK 


none 


[a;k],[b,y],[c,z],g 


Edit and mark: a per pattern B -> C, G = first significant 
result address 


FD 


3 


MCMPC 


D,DD43M, 

NIX, NIY 


[A,X],[B,Y],[Ca,Z] 


Compare bytes (character) per mask: find Aj^ == Bj^ per mask 
C, A & B index incremented by number of bytes compared 
before inequality found 


EA 


3 


MMRGC 


none 


[A,X],[B,Y],[C,Z],I8 


Merge bits per byte (character) mask: A or B per 18 = or 1 -> C 


F8 


3 


MOVE 


D,DC,DD,DDC, 
DM,NIX,NIZ 


[A,X],[C,Z],I8 


Move Bytes left: A ^ C (left to right); if A short, 18 ^ C for 
remaining bytes 


F9 


3 


MOVLC 


D,DC,DD,DDC, 
DM,NIX,NIZ 


[A,X],[C,Z],I8 


Move bytes left ones complement: A -> C (left to right); 
if A short, 18 -> C for remaining bytes 



o 

■^1 



n 

00 



Table C-13. String Instructions (Cont'd) 



Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


FA 


3 


MOVS 


no 


ne 


[A^],[C,Z],Bf 


Move and scale: A -* C, scale (B) decimal places 


E2 


3 


MPYB 






[A^],[B,Y],[C,Z] 


Multiply binary: A*B ^ C 


E6 


3 


MPYD 






[A,X],[B,Y],[C,Z] 


Multiply decimal: A*B ^ C 


D6 


3 


SRCHKEYB 






[A;K],[B,Y],[C,Z],Gf 


Search for masked key bits: search A for B per C, 
^index = # no match 


FE 


3 


SRCHKEYC 






[A^],[B,Y],[C,Z],Gf 


Search for masked key chars: search A for B per C, 
Aindex = * ^° "^atch 


FF 


3 


SRCHKEYW 






[A;K],[B,Y],[C,Z],Gf 


Search for masked key words: search A for B per C, 
Aindex = # no match 


El 


3 


SUBB 






[A;C],[B,Y],[C,Z] 


Subtract binary: A - B ^ C 


E5 


3 


SUBD 






[A^],[B,Y],[C,Z] 


Subtract decimal: A - B -^ C 


ED 


3 


SUBMOD 


none 


[A^],[B,Y],[C7],I8 


Modulo subtract bytes: (A^ - B^) mod(I8) -> Cj^ 


EE 


3 


TL 


D,DC,DD,DDC, 
DM,NIX,NIZ 


[a;k],[b,y],[c,z] 


Translate bytes: B^ ^ C^ 


D7 


3 


TLMARK 


CHJ)J)D,DM 


[A^],[Ba,Y],[C,Z] 


Translate and mark: A per B ^ vector C, translate 
Byte -> Cexponent' Partial A field index -> Ccoefficie 


EF 


3 


TLTEST 


D,DD,DM,NIX 


[A^],[B,Y],Zf,Cf 


Translate and test: B^ ^ C, A^ -^ Z if B^ .NE. 


FB 


3 


ZTOD 


NS,SS 


[a;c],[c^] 


Pack zoned to BCD: A -> C 



^O 

OO 

o 
to 

o 

o 



Table C-14. Lxjgical String Instructions 



OO 

o 

o 
o 

DO 



Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


Fl 


3 


AND \ 


\ 




Logical AND: A-B -^ C 


F6 


3 


ANDN 1 






Logical AND not: A-B -> C 


F2 


3 


lOR 1 


j 




Logical inclusive OR: A + B ^ C 


F3 


3 


NAND 1 


f 




Logical NAND: A-B -> C 


F4 


3 


NOR / 


none \ 


[a;k],[b,y],[c,z] 




Logical NOR: A + B ^ C 


F5 


3 


ORN I 


\ 




Logical OR not: A H- B^ C 


FO 


3 


XOR 






Logical exclusive OR: A - B -^ C 


F7 


3 


XORN / 


1 




Logical equivalence (exclusive OR not): A - B -> C 



n 



Table C-15. Non-Typical Instructions 



o 

O 



Op 



Mnemonic 



oo 
o 
to 

o 
o 

dd 



CF 

04 
39 
C4 
C6 
C7 
C5 
IE 

IF 
14 

BC 

DD 

06 

lA 

IB 



1 
A 

1 
1 
1 
1 

7 

7 
7 

2 
2 
7 
7 
7 



ARITHCPS 

BKPT 

CLOCK 

CMPEQ 

CMPGE 

CMPLT 

CMPNE 

CNTEQ 

CNTO 
CPSB 

CPSV 

DOTS 

FAULT 

FILLC 

FILLR 



Qualifiers 



B,H 



none 



none 



A,B,H 



none 

none 
none 

H,Z 
A,B,H 

none 
none 
none 



Operands 



[A^],[B,Y],Ca,Zo 

Ra 

Tf 

[A^],[B,Y],Zo 

[Rd.Sil ,Tf 

[Rd'Sil ,Tf 
Rd'^L'Td 

A r 7 

[Aa,Xo],[Ba,Yo],Cf.h 

15 

I8,[Td,Sil 

Rf,[Td,Si] 



Description 



Arithmetic compress: ABS(A) .GE. Bj^ -^ Cj^, 
set Zn, V length -> Zq.is 

Breakpoint: R 16-63 "^ breakpoint register 

Transmit (real time clock) -^ T 15.53, -> Tq.is 



Vector compare, form order vector: 

if (An) .OP. (Bn), set bit Z^ in order vector 



Count leading equals: # leading bits equal to bit at 
[R+S] -> T48.53 

Count ones in field R: # ones in field [R+S] -> T48.53 

Compress bit string: every R^ substring from Rn+S^ 
pattern -> T 

Compress vector: vector A -^ sparse C, controlled by O.V. Z 

Sparse vector dot product: A*B -> C, C+1 

Simulate fault 

Fill field T with byte (character) R: repeat 18 for field [T+S] 

Fill field T with byte (R): repeat (R56.63) for field [T+S] 



\o 
oo 
o 

o 
o 

CO 



Table C-15. Non-Typical Instructions (Cont'd) 



Op 



03 
7E 
12 
5E 
16 
ID 

BB 

IC 

D8 
D9 

18 

3D 
3C 



6 

7 
7 
7 
7 
7 



Mnemonic 



KYPT 

LOD 

LODC 

LODH 

MASKB 

MASKO 

MASKV 

MASKZ 

MAX 

MIN 

MOVR 

MPYX 
MPYXH 



Qualifiers 



none 



none 
A,B,H 

none 

H,Z 
H,Z 

none 

none 
none 



Operands 



Ra 

[Ra^Si] ,Tf 
[Ra>Si],Tf 

[Ra'SiUh 

Rd'Sd^Td 

RL'^L'Td 

RL'^L'Td 

[A,X] ,Bf,Cf.h,Z 
[A^],Bf,Cf_h,Z 

Ri'Si'Td 

Rf,Sf,Tf 
Rh'Sh'Th 



Description 



Keypoint 

Load full word: load [R^+Sj] -^ Tf 

Load byte (character): [Ra+Sj] -> T55.53, ^ ^ ^9.5 5 

Load halfword: load [Ra+Sj] -> T^ 

Mask bit strings: alternate (R^) string and (S^) string ^ Tgtring 

Form bit mask leading ones: repeat (R^j) ones and (Sd)-(Rd) 



zeros 



^ string 



Mask vector: if Z^^l, A^ ^ C^; if Zn=0, Bn -> €„; 
result length -> €045 

Form mask leading zeros: repeat (R^) zeros and (Sji)-(R^i) 



ones -^ Tstring 

Vector maximum: Aj^ax "^ ^' ^^®"^ count -> B 

Vector minimum: Aj^j^ "^ C» item count -> B 

Move bytes right: (T^) + (Ri) -> (T^) + (Ri) + (S^, 
bytes moved right -^ left 

Multiply index, full word: R^^.^^ * S16.53 ^ T16.63, -^ Tq.is 

Multiply index, half-word: Rg.3j * 83.3 j ^ T8.31, ^ TQ.y 



*Not valid on STAR- 100 



o 
4^ 



n 

to 



^0 
00 
O 
K) 

o 
o 

to 











Table C-15. Non-Typical Instructions (Cont'd) 


Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


15 


7 


MRGB 


none 


Rd>S(i,T(i 


Merge bit strings: interleave (R^j) string with (S^) string ^ 
T(i string 


17 


7 


MRGC 


none 


^d'Sd'Td 


Merge byte (character) strings: (R(j):(S(i), lesser -^ T^ 


BD 


2 


MRGV 


A3,H 


AajB^jC^^Q 


Merge vector: if 7^=1, A^ ^ €„; if 2^=0, B^ -> €„; 
result length -> Cq-is 


37 


A 


RJTIME 


none 


Tf 


Read job interval timer to (T) 


28 


7 


SCANLEQ 


) \ 




Scan left to right from [T(j,Sj] for byte equal to IS, index Sj 


29 


7 


SCANLNE 


) none > 


I8,[Td,Si] 


Scan left to right from [T^JS^] for byte not equal to IS, index S^ 


19 


7 


SCANRNE 


' ' 




Scan right to left from [T^ Sj] for byte not equal to IS, 
decrement S[ 


C8 


1 


SRCHEQ 


j j 






CA 
CB 


1 
1 


SRCHGE 
SRCHLT 


> H,LH^ > 


A,B,Ca>Z 


Vector search form indexed list: each (Ajj) .OP. (Bj^), count -^ Cj^ 


C9 


1 


SRCHNE 


) 1 






7F 


7 


STO 


none 


[Ra3i],Tf 


Store, full word: store (Tf) -^ address [Ra+Sj] 


13 


7 


STOC 


none 


[Ra'Si] ,Tf 


Store byte (character): T55.53 ^ address [Ra+Sj] 


5F 


7 


STOH 


none 


[Ra,Si] ,Th 


Store, half-word: (T^) -> address [Ra+Sj] 


89 


1 


TPMOV 


H,0 


[A,X],Bf-h.Yf.h,Ca 


Transpose and move 8 by 8 matrix 


3A 


A 


WJTIME 


none 


Rf 


Transmit (Rf) -> job interval timer 



Table C-16. Monitor Instructions 



\o 

00 

o 

O 

o 

CO 



Op 


F 


Mnemonic 


Qualifiers 


Operands 


Description 


00 


4 


IDLE 


no 


ne 


none 


Idle: enable external interrupts and idle 


OD 


4 


LODAR 






none 


Load associative registers: full words beginning at 400XX8 ^ AR 


OF 


4 


LODKEY 






Rf'Sa,Ta 


Load keys from (Rf), translate virtual (S^) to absolute T^ 


OA 


4 


MTIME 






Rf 


Transmit (Rf) -> monitor interval timer 


08 


4 


SETCF 






Rf 


Input/output: set channel (Rf) channel flag 


OC 


4 


STOAR 






none 


Store associative registers: AR -^ 400YY8 and higher addresses 


OE 


4 


TLXI 


] 


1 


[Ra'Sil ,Tf 


Translate external interrupt: (Tf) == highest priority channel with 












interrupt, branch to Ra[Si] 



o 

u> 



Table C-17. Register Designators 

Designator Deso-iption 

a a full word register containing an address; length field is ignored 

f full word register containing an operand 

h half word register containing an operand 

i full word register containing an index 

d full word register containing a descriptor 

e full word register whose length field contains an operand 

o full word register containing descriptor of order vector 

The 64 bit instructions are assumed: 



A, B, 


c 


Descriptors of operands 




X, Y 




Index 




Z 




Alone - control vector address in a register pair - 


- index 


R, S, 


T 


word in register file 




R.J. 




right justified 




S.E. 




sign extended 




FP. 




floating point 




N/A 
none 




not available 
qualifier not specified 




O.V. 




order vector 




.OP. 




arithmetic operator (GE . . . LT . . . LE . . 


. etc.) 
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JOB PROCESSING 



This appendix contains a description of the assembler call statement, and the options associated with that 
statement. Also provided are examples of interactive and batch processing deck set-ups and terminal commanck. 

ASSEMBLE statement 

FORMAT: 

META I=SOURCE L=PRINT 6 = 61 NARY / 500 I 

+fields can be separated by any characters other than 1-9,A-Z or underscore. Blanks can be used as 
separators 

Parameters I, L and B may appear in any order 

where 

I = source file name - the user must have previously created the source file assigned the name 

specified. In batch mode the source cards following the control card stream 
are assumed the input file. The input file may be compressed on expanded. 

L = print file name - the print file name is optional and if not specified, Ustable output will be 
automatically placed on file "PLIST" by the assembler. When PLIST is 
used, only the letter L is required, approximately 300 blocks are reserved 
for PLIST. To print an output Usting the user must always specify the 
following statement: GIVE (output Usting file, U = 999999) 

B = binary file - this parameter can be omitted if only a syntax check is desired. 

EXAMPLE INTERACTIVE ASSEMBLE, LOAD, EXECUTE 

1. The assembler deck as shown below was input via the card reader. 



LOGON 999997 400SDS TESTDECK R S 
META SOURCE CARDS 



^7. 



9 
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2. After the assembler deck was read in, at the terminal the following was entered: 

LOGON 999997 A 400SDS W^ 
CREATECOBJECT02,01,T=P) U 

CREATECPRINT002,20,T=P) lt_ 
META(I=TESTDECK,L=PRINT002,B = OBJECT2)/ 500 I It 



GIVECPRINT002,U=999999) U 

LOAD / 1000 I £f 

INPUT? 

OBJECT02 

ORIGIN? 

#28000 £f 

ENTRY? 

M 

ANY OTHER OPTIONS? 

CONTINUE 

CN = TONY^OU-PRINTMAP U_ 
CONTINUE 

U_ 

GIVECPRINTMAP,U=999999) 

TONY / 500 I 
$ 



dispose assembler listing to printer 

Request loader program 

Request from loader 

User supplied private file names 

Request from loader 

First Module loading bit address 

Request from loader 

User indicates no options 

Request from loader 

User indicates LIBRARY option 

Answer from loader 

User indicates controUee and loadmap option 

Answer from loader 

Terminates options and starts load operations 

Dispose loader map to printer 

Execute the loaded program 



NOTE: the file PRINTMAP is automatically created 
* £f = line feed 
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EXAMPLE BATCH ASSEMBLE, LOAD, EXECUTE 



(1) 

(2) 12:00 

(3) 12:00 

(4) 12:00 

(5) 12:00 

(6) 12:01 

(7) 12:01 

(8) 12:02 

(9) 12:02 
(10) 12:02 



LOGON 999997 400SDS ZBATCH R S B U 

59 TESTS^TIOOO. 

59 CREATECBINARY, 02^ T=P) 

59 CREATECPLIST^10,T=P) 

59 METACI=INPUT,B = BINARY, L^PLIST) 

59 GIVECPLIST^U=999999) 

59 LOADCBI NARY^ CN=TONY, OU=PMAP) 

59 GIVECPMAP,U=999999) 

59 TONY . 

59 $$COMPLETE$$ 



^CARD READER ID 

'JOB ID 

^FILE CREATION 

^FILE CREATION 

^ASSEMBLE META 

^TRANSFER FILE 

^LOAD ASSEMBLER OUTPUT 

^TRANSFER FILE 

= EXECUTE CONTROLEE TONY 

^MESSAGE FROM SYSTEM 



META DECK 



FINIS 



(1) The card reader ID card is not field free and variable length names are not allowed. 



Columns 


Content 


Parameter 


1-5 


LOGON 


Card reader ID 


7-12 


999997 


User number 


14-19 


400SDS 


Account number 


21-28 


ZBATCH 


File name 


30 


R 


Record structural file 


32 


S 


Physical file 


34 


B 


Batch processor to be 


36 


U 


Unrestricted access 



(2) Job ID card must contain the job name 
TEST 8 Job name 

TIOOO Time in seconds 
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(3) Treats a physical file named BINARY 

BINARY FUe name 

10 Length of file in 512 word blocks 

T=P File type in physical data file 

(4) The P in PLIST will signal USERl that file is a print file 

PLIST File name 

I 10 Length of file in 512 word blocks 

T=P FUe type is physical data file 

(5) Assemble META from the card reader and produce binary output on file BINARY and a listing on file 
PLIST 

I=INPUT Data from unnamed records may be accessed by referencing a file named INPUT 
in this INPUT in the card reader 

I B=BINARY Object code to BINARY 

L=PLIST Assembly listing to PLIST 

(6) Transfer the file PLIST to USERl routine 

PLIST Source file 

U=999999 USERl routine will see that first character of transfer file is P thus a print file 

(7) Load the assembler object code into controlee file TONY and place load maps and error messages on 
PMAP 

BINARY Source file - file to be loaded 

CN=TONY Controlee file is TONY 

OU=PMAP Load maps and error messages on PMAP 

(8) Transfer load maps and error messages to USERl 

PMAP Source file 

U=999999 USERl routine will see that first character of transfer file is P thus a print file 

(9) TONY Find this controllee file and execute it 

For a more complete description of the control card used in these set-up examples, see the STAR Operating 
System Reference Manual, PubUcation No. 60384400. 
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ASSEMBLY LISTING FORMAT 




HEADER STAR 

FORMAT: ASSEMBLER VER. X.X 



title PAGE nnnn 



The title is blank unless a title is indicated on a TITLE directive. 
The nnnn is the page number of the listing. 

ADDRESS (P) COUNTER 

FORMAT: RR. WWVWVWW B 



RR 

V's 
B 



Hex value of the currently active memory control section ordinal (begins at 01, with a 
range of 01 to FF) 

Hex value of the current location counter 

Boundary indicator for current location counter 
F Bit address at FULL word boundary 
H Bit address at HALF word boundary 
C Bit address at BYTE (character) boundary 
B Bit address at BIT boundary 
No effect on location counter 
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OBJECT CODE 

This field contains the object code in hex. 

A maximum of 64 bits of object code appear per line, new lines will be generated for any bits over 64. 

Any object code that has relocation will be followed by the ordinal number. 

Each field of the object code that has relocation will be on a separate line. 

EXAMPLE: 

B645 BIM R_45, label 

XXXXXXXXXXXX (n) 

B6 Function code for BIM 

45 Index register 45 

X's Relocatable address 

n Ordinal number 



IV SOURCE CODE 

This field contains a copy of the source lines processed. 

V PAGE/LINE NO. 

This field indicates the page and line number of each source line. 



E-2 19980200 A 



ERROR MESSAGES 



STATEMENT TERMINATING ERROR MESSAGES 

UNDEFINED SYMBOL 

MULTIPLY DEFINED SYMBOL 

ILLEGAL ALIGNMENT VALUE 

ILLEGAL OR MISSING LABELS 

ILLEGAL OPERAND/PARAMETER 

OPERAND NOT A LEGAL SET ELEMENT 

MORE THAN 255 EXTERNALS 

EXTERNALIZATION NOT ALLOWED AT UNIVERSAL LEVEL 

IMPROPER USE OF EXTERNAL OPERAND IN EXPRESSION 

FUNCTION NAME USED AS OPERAND 

SET NAME USED AS OPERAND IN EXPRESSION 

ASSEMBLER'S CAPACITY FOR RELOCATION EXCEEDED 

RELOCATABLE TERM ILLEGAL IN EXPRESSION CONTAINING EXTERNAL SYMBOL 

IMPROPER USE OF RELOCATABLE TERMS IN EXPRESSION 

MULTIPLE RELOCATION ON RESULT OF EXPRESSION 

OPERANDS FOR RELATIONAL EXPRESSION HAVE UNLIKE RELOCATION 

SUBSCRIBED REFERENCE TO A VARIABLE THAT IS NOT A SET 

IMPROPER MODE IN SUBSCRIPT 

REPEAT COUNT MISSING/NOT AN INTEGER 

IMPROPER NESTING OF REPEATS 

IMPROPER MODE ON REPEAT VARIABLE 
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PROCEDURE LIBRARY I/O ERROR. SEARCH ABORTED. 

SYNTAX ERROR IN PROCEDURE/FUNCTION SOURCE STATEMENT, LIBP ABORTED 

PROCEDURE/FUNCTION NOT FOUND IN LIBRARY 

FILE NAME NOT A 6 CHARACTER SYMBOL 

ILLEGAL USE OF .ELM. OPERATOR 

IMPROPER USE OF POSITION OPERATOR, (:) 

DATA GENERATION ILLEGAL AT UNIVERSAL LEVEL 

COMMAND FIELD SYMBOL UNDEFINED AT THIS LEVEL 

FORM REFERENCE ILLEGAL AT THIS LEVEL 

FUNCTION MAY NOT ALTER PCOUNTER 

COMMAND IS NOT A SYMBOL 

ILLEGAL NAME FOR PARAMETER SET IN FUNC/PROC STATEMENT 

ILLEGAL PASS VALUE 

ILLEGAL DATA IN FORM/GEN 

MISSING OPERATOR 

MODE ERROR IN EXPRESSION 

MISSING OPERAND 

ILLEGAL SYMBOL 

ILLEGAL HEX CONSTANT 

ILLEGAL OPERATOR 

ILLEGAL STRING CONSTANT 

UNMATCHED PAREN 

UNMATCHED BRACKET 

SYNTAX IS ILLEGAL 

OPERAND NOT A CHARACTER STRING CONSTANT 

ATTRIBUTE NUMBER OUT OF RANGE 

JOB ABORTED, ILLEGAL PARAMETER IN INPUT STATEMENT 
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EXTRINSIC ATTRIBUTE NOT AN INTEGER VALUE 

ILLEGAL TRANSFER ADDRESS IN END STATEMENT 

MSEC DOES NOT CORRESPOND, PASS 2 PER PASS 1 

DATA DOES NOT CORRESPOND,PASS 2 PER PASS 1 

MORE THAN ONE OUTPUT/LISTING STATEMENT IN ASSEMBLY 

ILLEGAL PARAMETER IN FUNCTION CALL 

REFERENCE TO UNDEFINED ENTRY POINT 

SYMBOL NOT A LEGAL OPERAND 

TRUNCATED REGISTER VALUE 

ILLEGAL VALUE FOR A REGISTER 

RELATIVE JUMP OUT OF RANGE 

RELATIVE BRANCH TO ADDRESS EXTERNAL TO MSEC 

RELOCATABLE OR EXTERNAL DATA DOES NOT END ON WORD BOUNDARY 

DATA GENERATED FOR AN EXTERNAL OR RELOCATABLE VALUE LESS THAN 48 BITS 

IMPROPER USE OF REAL IN EXPRESSION 

ILLEGAL SET STRUCTURE 

RELOCATION NOT ALLOWED IN CODE MSEC 

OPERATING ON EXTERNALS NOT SUPPORTED BY LOADER 

REPEAT SYMBOL REDEFINED IMPROPERLY SYMBOL DROPPED 

FORWARD REFERENCE TO REDEFINABLE QUANTITY IS ILLEGAL 

ILLEGAL TO REDEFINE DIRECTIVE 

WARNING MESSAGES 

WARNING - DIVISION BY ZERO INTEGER YIELDS ZERO RESULT, REAL YIELDS INDEFINITE 

WARNING - BINARY SCALE FACTOR GREATER THAN 47 APPLIED 

WARNING - SUBSCRIPT OUT OF RANGE, NULL ELEMENT USED 

WARNING - IDENT/FINIS/ENDP/PROC/FUNC/LIBP CANNOT APPEAR IN REPEAT RANGE 
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WARNING - TOO MANY ELEMENTS IN LIST, RIGHTMOST ELEMENTS ARE IGNORED 

WARNING - LABELS ARE NOT ALLOWED, ANY APPEARING ARE IGNORED 

WARNING - GOTO BRANCH NOT PERFORMED, JUMP VALUE NOT AN INTEGER EXPRESSION 

WARNING - NO MODIFIERS REQUIRED BY THIS STATEMENT, ANY APPEARING ARE IGNORED 

WARNING - ENTRY/EXTERNAL/IDENT CONTAINS MORE THAN 8 CHARACTERS - ONLY FIRST 
EIGHT RETAINED 

WARNING - DEFAULT ASSUMED FOR ILLEGAL MSEC PARAMETER 

WARNING - CONSTANT TRUNCATED 

WARNING - DATA TRUNCATED 

WARNING - REAL EXPONENT OVERFLOW 

WARNING - REAL EXPONENT UNDERFLOW 

WARNING - POSSIBLE GARBAGE IN FILE 

WARNING - TOO MANY PARAMETERS IN FUNCTION CALL, RIGHTMOST PARAMETER IGNORED 

WARNING - DATA IMPROPERLY ALIGNED FOR MODE OF OPERAND 

WARNING - EXTRA SET ELEMENTS ARE IGNORED 

WARNING - MONITOR INSTRUCTION IN JOB MODE MSEC 

WARNING - ILLEGAL QUALIFIERS IGNORED 

WARNING - DISALLOWED BITS SET IN G FIELD 

WARNING - OFFSET/RESULT REGISTER NOT EVEN 

WARNING - OVERLAPPING QUALIFIER DEFINITIONS 

WARNING - RELATIVE JUMP NOT IN DIRECTION INDICATED 

WARNING - FIRST ENTRY IN LABEL FIELD IS AN EXPRESSION 

WARNING - BINARY SCALE ON RELOCATABLE ADDRESS 

WARNING - POSSIBLE MISSING OPERAND IN INSTRUCTION 

WARNING - MISSING QUALIFIER 

WARNING - REGISTER VALUE NOT ALIGNED TO APPROPRIATE BOUNDARY 
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WAEINING - AUTOMATIC ALIGNMENT PERFORMED FOR DATA TYPE INDICATED, LABELS MAY NOT 
CORRESPOND TO START OF DATA 

WARNING - LOADER RESTRICTION TRUNCATED TO FIRST EIGHT CHARACTERS 

WARNING - DOUBLY DEFINED ENTRY POINT 

WARNING - VALUE FROM ANOTHER LEVEL USED FOR 

ASSEMBLER FAILURE MESSAGES 

SYSTEM ERROR - SI - ILLEGAL USE LEVEL IN SYMBOL TABLE 

SYSTEM ERROR - S2 - ILLEGAL MODE IN SYMBOL TABLE 

SYSTEM ERROR - S3 - ILLEGAL ITEM IN SYMBOL TABLE - DRIVER 

SYSTEM ERROR - S4 - LOCATION COUNTER VALUES DO NOT AGREE PASS 2 PER PASS 1 

SYSTEM ERROR - S5 - ILLEGAL CHARACTER TRANSLATION VALUE DETECTED - TOKEN 

SYSTEM ERROR - S6 - ILLEGAL TOKEN TYPE DETECTED - RPOL 

SYSTEM ERROR - S7 - ILLEGAL VALUE FROM COMBINED TOKEN TABLE - TOKEN 

SYSTEM ERROR - S8 - MISSING END OR FINIS - - - JOB ABORTED 

SYSTEM ERROR - S9 - ILLEGAL TOKEN TYPE DETECTED IN EVAL 

SYSTEM ERROR - SIO - ILLEGAL TOKEN NUMBER DETECTED IN EVAL 

SYSTEM ERROR - Sll - ILLEGAL SYMBOL TABLE MODE - EVAL 

SYSTEM ERROR - S12 - ILLEGAL SYMBOL TABLE ITEM TYPE - EVAL 

SYSTEM ERROR - S13 - ZERO LENGTH TOKEN - EVAL 

SYSTEM ERROR - S14 - ILLEGAL OPERATOR DETECTED IN RPOL - COMMA 

SYSTEM ERROR - S15 - BAD Q ORDINAL ENTRY IN COMMAND TABLE - INST_P 

SYSTEM ERROR - S16 - BAD TEMPLATE FOR INSTRUCTION - INSTP 

SYSTEM ERROR - S17 - LIMIT FOR EVAL ADDRESS STACK REACHED 

SYSTEM ERROR - S18 - LIMIT FOR RPOL OPERAND STACK REACHED 

SYSTEM ERROR - S 19 - NO SIGN ON ZONED CONSTANT - CONVERSION FUNC 
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ASSEMBLER PREDEFINED COMMAND-SYMBOLS 



Symbols in the following table have a special meaning to the assembler command field. 



Table G-1. Predefined Symbols 





Function Code 


= 


Symbol 


or Value (hex) 


Use 


A 


10 


Mnemonic qualifier 


ABS 


79 


Instruction mnemonic 


ABSH 


59 






ABSV 


99 






ADDB 


EO 






ADDD 


E4 






ADDL 


61 






ADDLEN 


2B 






ADDLH 


41 






ADDLS 


Al 






ADDLV 


81 






ADDMOD 


EC 






ADDN 


62 






ADDNH 


42 






ADDNS 


A2 






ADDNV 


82 






ADDU 


60 






ADDUH 


40 






ADDUS 


AO 






ADDUV 


80 






ADDX 


63 






ADDXV 


83 






ADJE 


75 


] 


1 


ADJEH 


55 


Instructio] 


1 mnemonic 
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Table G-1. Predefined Symbols (continued) 



! 

Symbol 


Function Code 
or Value (hex) 


Use 


ADJEV 


95 


Instruction mnemonic 


ADJMEAN 


Dl 






ADJS 


74 






ADJSH 


54 






ADJSV 


94 






ALG 


05 






AND 


Fl 






ANDN 
ARITHCPS 


F6 
CF 


Instruction 


mnemonic 


ATT 


— 


Function name 


AVG 


DO 


Instruction mnemonic 


AVGD 


D4 


Instruction mnemonic 


B 


08 


Mnemonic qualifier 


BAB 


32 


Instruction mnemonic 


BADF 


33 






BARB 


2F 






BEQ 


24 






BGE 


26 






BHEQ 


20 






BHGE 


22 






BHLT 


23 






BHNE 


21 






BIM 


B6 






BKPT 


04 






BLT 


27 


Instruction mnemonic 


BNE 


25 


BR 


40 


Mnemonic qualifier 


BRB 


06 


Mnemonic qualifier 


BRF 


04 


Mnemonic qualifier 


BRIEF 


— 


Directive 


BRO 


80 


Mnemonic ( 


jualifier 
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Table G-1. Predefined Symbols (continued) 





Function Code 




Symbol 


or Value (hex) 


Use 


BRZ 


CO 


Mnemonic qualifier 


BSAVE 


36 


Instruction mnemonic 


BTOD 


11 


Instruction mnemonic/ 
function name 


C 


02 


Mnemonic qualifier 


CH 


04 


Mnemonic qualifier 


CLG 


72 


Instruction mnemonic 


CLGH 


52 






CLGV 


92 






CLOCK 


39 






CMPB 


E8 






CMPD 


E9 






CMPEQ 


C4 






CMPGE 


C6 






CMPLT 


C7 






CMPNE 


C5 






CNTEQ 


IE 






CNTO 


IF 






CON 


76 






CONV 


96 






CPSB 


14 


1 


) 


CPSV 


BC 


Instruction mnemonic 


D 


80 


Mnemonic qualifier 


DBNZ 


35 


Instruction mnemonic 


DC 


20 


Mnemonic qualifier 


DD 


CO 


Mnemonic qualifier 


DDC 


30 


Mnemonic qualifier 


DELTA 


D5 


Instruction mnemonic 


DETAIL 


— 


Directive 


DIVB 


E3 


Instruction 


mnemonic 
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Table G-1. Predefined Symbols (continued) 



Symbol 



Function Code 
or Value (hex) 



Use 



DIVD 

DIVS 

DIVSH 

DIVSS 

DIVSV 

DIVU 

DIVUH 

DIVUS 

DIVUV 

DM 

DOTS 

DOTV 

DTOB 

DTOP 

DTOZ 

EJECT 

ELEN 

EMARK 

END 

END? 

ENTRY 

EORG 

EQU 

ES 

ESH 

EX 

EXH 

EXTB 

EXTC 

EXTD 

EXIT 



E7 

6F 

4F 

AF 

8F 

6C 

4C 

AC 

8C 

30 

DD 

DC 

10 

FC 

2A 
EB 



3E 
4D 
BE 
CD 
6E 



09 



Instruction mnemonic 



Instruction mnemonic 
Mnemonic qualifier 
Instruction mnemonic 
Instruction mnemonic 
Instruction mnemonic 
Function name 
Instruction mnemonic 
Directive 

Instruction mnemonic 
Instruction mnemonic 
Directive 



Directive 

Instruction mnemonic 



Instruction mnemonic 

Directive 

Directive 

Instruction mnemonic 



G4 
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Table G-1. Predefined Symbols (continued) 



Symbol 



Function Code 
or Value (hex) 



Use 



EXITP 

EXP 

EXPH 

EXPV 

EXTH 

EXTV 

EXTXH 

FAULT 

FILLC 

FILER 

FINIS 

FLR 

FLRH 

FLRV 

FORM 

FUNC 

FF32 

F32F 

GEN 

GOTO 

H 

HTOC 

IBNZ 

IBXEQ 

IBXGE 

IBXGT 

IBXLE 

IBXLT 

IBXNE 

IDENT 

IDLE 

IMEM 



7A 
5A 
9A 
5C 
9C 
5D 
06 
lA 
IB 

71 
51 
91 



80 

31 
BO 
B2 
B5 
B4 
B3 
Bl 

00 



Directive 

Instruction mnemonic 



Instruction mnemonic 

Directive 

Instruction mnemonic 

Instruction mnemonic 

Instruction mnemonic 

Directive 

Directive 
Function name 
Function name 
Directive 
Directive 

Mnemonic qualifier 
Function name 
Instruction mnemonic 



Instruction mnemonic 
Directive 

Instruction mnemonic 
Default MSEC name 
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Table G-1. Predefined Symbols (continued) 





Function Code 




Symbol 


or Value (hex) 


Use 


INPUT 


6D 


Instruction mnemonic 


INSB 








INTERVAL 


DF 






lOR 


F2 






IS 


3F 


' 


' 


ISH 


4E 


Instruction mnemonic 


ITOC 




Function name 


ITOF 




Function name 


IX 


BF 


Instruction mnemonic 


IXH 


CE 


Instruction mnemonic 


*KYPT 


03 


Instruction mnemonic 


LIBP 


\ 


Directive 


LIST 




Directive 


LISTING 




Directive 


LH 


20 


Mnemonic qualifier 


LOD 


7E 


Instruction mnemonic 


LODAR 


OD 






LODC 


12 






LODH 


5E 






LODKEY 


OF 






LSDFR 


3B 




f 


LTOL 


38 




LTOR 


7C 


Instruction mnemonic 


MA 


04 


Mnemonic qualifier 


MASKB 


16 


Instruction mnemonic 


MASKO 


ID 






MASKV 


BB 


' 


f 


MASKZ 


IC 




MAX 


D8 


Instruction mnemonic 


MB 


01 


Mnemonic qualifier 


MCMPC 


FD 


Instruction 


mnemonic 



MESSAGE 

*Not valid on STAR- 100 



Directive 
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Table G-1. Predefined Symbols (continued) 



Symbol 



MIN 

MMRGC 

MOVL 

MOVLC 

MOVR 

MOVS 

MPYB 

MPYD 

MPYL 

MPYLH 

MPYLS 

MPYLV 

MPYS 

MPYSH 

MPYSS 

MPYSV 

MPYU 

MPYUH 

MPYUS 

MPYUV 

MPYX 

MPYXH 

MRGB 

MRGC 

MRGV 

MSEC 

MTIME 

N 

NAME 

NAND 



Function Code 
or Value (hex) 



D9 

EA 

F8 

F9 

18 

FA 

E2 

E6 

69 

49 

A9 

89 

6B 

4B 

AB 

8B 

68 

48 

A8 

88 

3D 

3C 

15 

17 

BD 

OA 
06 

F3 



Use 



Instruction mnemonic 



Instruction mnemonic 

Directive 

Instruction mnemonic 

Mnemonic qualifier 

Directive 

Instruction mnemonic 
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Table G-1. Predefined Symbols (continued) 





Function Code 




Symbol 


or Value (hex) 


Use 


NCC 


01 


Mnemonic qualifier 


NIX 


04 






NIY 
NIZ 


01 
01 


T 

Mnemonic qualifier 


NOLIST 




Directive 


NOR 


F4 


Instruction mnemonic 


NS 


CO 


Mnemonic qualifier 





20 


Mnemonic qualifier 


ORG 




Directive 


ORN 


F5 


Instruction mnemonic 


OUTPUT 


— 


Directive 


PACK 


7B 


Instruction mnemonic 


PACKH 


5B 






PACKV 
POLYEVAL 


9B 
DE 


T 
Instruction mnemonic 


PROC 




Directive 


PRODUCT 


DB 


Instruction mnemonic 


PTOI 


— 


Function name 


PTOZ 


— 


Function name 


RAND 


2D 


Instruction mnemonic 


RATT 




Directive 


RCON 


77 


Instruction mnemonic 


RCONV 


97 


Instruction mnemonic 


RDEF 


— 


Directive 


RES 




Directive 


RIOR 


2E 


Instruction mnemonic 


RJTIME 


37 


Instruction mnemonic 


RPT 




Directive 


RTOR 


78 


Instruction mnemonic 


RTORH 


58 


Instruction mnemonic 


RXOR 


2C 


Instruction 


mnemonic 
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Table G-L Predefined Symbols (continued) 



Symbol 


Function Code 
or Value (hex) 


Use 


SCANLEQ 


28 


Instruction mnemonic 


SCANLNE 


29 


Instruction mnemonic 


SCANRNE 


19 


Instruction mnemonic 


SET 


— 


Directive 


SETCF 


08 


Instruction mnemonic 


SELEQ 


CO 






SELGE 


C2 






SELLT 


C3 






SELNE 


CI 






SHIFT 
SHIFTI 


34 
30 


Instruction 


r 
mnemonic 


SPACING 


— 


Directive 


SQRT 


73 


Instruction mnemonic 


SQRTH 


53 






SQRTV 


93 






SRCHEQ 


C8 






SRCHGE 


CA 






SRCHKEYB 


D6 






SRCHKEYC 


FE 






SRCHKEYW 


FF 






SRCHLT 


CB 






SRCHNE 


C9 


V 

Instruction mnemonic 


SS 


80 


Mnemonic qualifier 


STO 
STOAR 


7F 

oc 


Instruction 


mnemonic 


STOC 


13 






STOH 


5F 




' 


SUBB 


El 






SUED 


E5 






SUBL 


65 






SUBHL 


45 


Instruction i 


nnemonic 
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Table Lr-ll Predefined Symbols (continued) 





Function Code 




Symbol 


or Value (hex) 


Use 


SUBLS 


A5 


Instruction mnemonic 


SUBLV 


85 






SUBMOD 


ED 






SUBN 


66 






SUBNH 


46 






SUBNS 


A6 






SUBNV 


86 






SUBU 


64 






SUBUH 


44 






SUBUS 


A4 






SUBUV 


84 






SUBX 


67 






SUBXV 


87 






SUM 


DA 


T 


SWAP 


7D 


Instruction mnemonic 


SYM 




Function name 


SZ 


30 


Mnemonic qualifier 


T 


10 


Mnemonic qualifier 


TITLE 




Directive 


TL 


EE 


Instruction mnemonic 


TLMARK 


D7 






TLTEST 


EF 






TLXI 


OE 






TPMOV 


B9 






TRU 


70 






TRUH 


50 






TRUV 


90 






VREW 


B8 






VTOV 


98 


^ 


' 


VTOVX 


B7 


Instruction 


mnemonic 
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Table G-1. Predefined Symbols (continued) 





Function Code 




Symbol 


or Value (hex) 


Use 


VXTOV 


BA 


Instruction mnemonic 


WJTIME 


3A 






XOR 


FO 


T 


XORN 


F7 


Instruction mnemonic 


XTOD 




Function name 


Z 


40 


Mnemonic qualifier 


ZTOC 




Function name 


ZTOD 


FB 


Instruction mnemonic 


ZTOP 




Function name 



19980200 A 



G-11 



ASSEMBLER LIMITATIONS H 



The following limits must be observed: 

Maximum symbol length is 63 characters. 

Maximum number of memory sections per subprogram is 255. 

Maximum number of nested procedures or function calls is 128. 

Maximum number of nested subsets is 32. 

Maximum number of nested repeat operators is 32. 

Maximum number of extrinsic attributes is 120. 

Maximum number of nested parentheses in an expression is 60. 
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EXAMPLES 



The following examples illustrate a number of the available assembler directives and various machine instruction 
types. These examples were run on the STAR 65 computer system. A statement of the problem to be solved 
and a description of the assembler code are provided. 

For a description of the register conventions illustrated in the executable examples (vector examples), see 
appendix E of the STAR Operating System Reference Manual, Publication No. 6038400. 



DATA GENERATION 

The following examples illustrate three methods of generating data. These examples illustrate the basic use of 
the following assembler difectives. 



INPUT 


RPT 


IDENT 


GEN 


OUTPUT 


END 



Example 3 also illustrates the use of functions and sets and is described in detail. 
Example 1 — generates integers 1 to 10 at assembly time using the GEN directive. 



CQC STAR ASSEHBL£R VI^R 2.^.2 



OATEt 12SEP7<» PAGE 



ul uuitCtiuGuCt 

Ul aQClUwbX«.!» 

i)l uat.bt.biil'tu 

wl uiilibwwUldb 

Ul uJtbudJlCii 

wl Ut;Ci«uuli2uu 

Jl UUitbbU^Hb 



F oajaCGua uu;jjO&oi 

F iiJJwtiiidJ QuJGub02 

F oJJjUb3b uubuJu03 

F JJjjlbUJ UtfuubCiu'f 

F U^iiubuJJ tiJjQuGuS 

F liSUJQuJj Utiu<iliuC6 

F uUJJCbUu jUi>UaC07 

F aJJJbuUj bbdbOCibS 

F JJ330t.i)0 iiuoaubd9 

F ujJdbiJJ;i JdwSuUUA 



VALUE 



INFUT 1»80 

lOENT 

GEN*6i» It2*3»<»»5t6f7«8i9tl0 



1/oaoi 

1/G0b2 
1/C003 



ENC 



1/00 0<» 



Example 2 - generates integers 1 to 10 at assembly time using the GEN and RPT directives. 



COC STAR ASS£MdL£R VER 2.2.2 



OATEk 12SEP7II PAGE 



bl gwt.CJfaJ;.Jj 

Jl buLt. J00u<*b 

j1 jOtbubu aSb 

lil iiuLbu^UuCu 

J 1 UbLl HbxlltU 

Jl •.blbwLOmb 

Jl tfoliibbClSu 

til k.bl.taybi>lCb 

Jl Jllbllib J2jb 

Ul dUL«iuuu2<»u 



0£C IJ 

f aJjbwuUJ bUJdiitJl 

F JJjyJbOj JUuO«bU2 

F OJJaubJb CiwuJOubS 

F jJJUGbJtt ilbudObO^t 

F ujJuCbJu uOxUbCCS 

F dJjjuba^ ubC'JGubb 

F OJilwbJja (JuUubbC7 

F J,«.<uubJu dOriiJubwS 

F JJjJuuJ'b Ubiiu0ub9 

F tiJJuttbJu UbbJOGiiiA 





INFUT 1,80 




CUTPtT 




lOCNT 


A 


RPT.IU 2 


2 


GCK A 



l/CdOl 
1/G0S2 
1/0003 
1/C00<i 

i/oao5 



ENC 



1/8906 
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Example 3 — generates a set of integers 1 to 10 by use of a function. 



COC STAR ASScHdLEH VER 2.2.2 



DATE I iZSEPTit PACE 



INPUT 1,90 fi 

OUTPUT 

TITLE "6ENERATE StT VALtiES* 



1/OObl 

l/iit)02 



COC STAR ASSEHSLcR VtR 2.2.2 



GENERATE SET VALUES 



DATE I 12SEP7i> PAGE 















ruKC z 












INT 


NAHE 












RESULT 


StT i 












li 


KPT,i(lJ-l 1 












ItREStLT 


SET .ELM. RESULT ,B»1 

ENCP RESULT 

lOENT 


{,1 


j » L l> 1. 1 u u 3 




«tJJjlCOi> 


ilUuObUDl 




GEN .ELH.INTflOl 


ai 


UwLCuto. jHu 




d J JubiitiO 


uauC3uti2 






ul 


Jul LuwUii tiu 




j^OJbOOJ 


i) ti b ti u b 1} 3 






<il 


ubbC.JUbOt. 




U jJgbbJb 


UUUuQwm 






ul 


auLCKbUlUU 




aJj.biiOU 


bbuOubbS 






^X 


bw«.(i»b3l<*u 




tlJJulbwb 


u00iibbb6 






Jl 


«ulbu»Ci8U 




UjJjbbjJ 


UUubbbO? 






Jl 


OblLi^bblCC 




liu J Jbiibw 


UuuJwUuS 






rtl 


uUl«C jwu^tfb 




JJiJUbgii 


udUuJCbS 






01 


Ubt.CwUu2<»ii 




ujJjCw ja 


ildwUtibaA 







i/ujim 

l/Ogu$ 
1/UJU6 
1/buJ/ 

i/ojos 

l/bd09 
i/bJlO 
1/Odii 



ENC 



l/6dl2 



In this example, two assembler features are used — functions and sets. The name of the defined function is 
INT. The function is called in the GEN statement. The call requests the generation of all set elements and 
passes a value of 10 decimal to list Z in the FUNC statement. Initially, RESULT is set to a value of 1 and 
then in the RPT statement sets the value of B which is later added to the value 1 in the statement labeled 
1, RESULT. 

In the RPT statement command list, Z [1]-1 calls for the first element of set Z, which is the value of Z [10] 
minus 1. This sets the iteration count for the RPT directive. Even though set Z consists of one element, if it 
were referenced as Z only, a diagnostic would be issued. The final statement in the funcdon definition is the 
ENDP directive; it specifies that the value assigned to RESULT be returned to the function call statement. 



ATTRIBUTE REFERENCING 

The ATT directive is illustrated in example 4. The purpose of this example is to determine whether a group 
of characters constitute a character string. A function is used for character string determination, and the ATT 
and GOTO statements are illustrated. 



1-2 
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COL Uthn AUii-HbLLK 4LR d,i,Z 
COL STAR ASSEHatER V£R 2.2.2 



t)l ClC0Juui}G3 F aaOCObOO ii0uC00b9 
NOT A CHARACTtR STRING 

MORE TMAN 1 Ei.£M£r,'T PASSED 

jl uCtttJwC jv.80 r Ci<j JCiddJO OUOUIibCO 

MORE THAN 1 ECEHt.a PASSED 

j1 UCkCi, JI.,;ICU F JJ^CuUuU wJdiiUiitiO 

1 CDC STAR ASSEMBLER tftR 2.2.2 
i>hUM3ER OF EARNING r<ESSAG£S = 3 
NUMBER OF ERROR MESSAGES s 3 
1 CDC STAR ASSEMBLER V£R 2.2.2 
i 





OATLl 12SCP7i» 


PAGE 


1 


INPIT «l&{i,£0 






1/0001 


TITLE "CHAR*CTER_STHrKd.SIZE_FUNCTION- 






muz 


CHAfiACTER_STRING_SI2E FUNCTION 


DATEl 12S£P7ii 


PAGE 


2 


FUhC a 






1/3003 


CHAR.COUKT NAME 






i/ggQj, 


GCTC,ATTIAIl),2).Ea.7 1 






l/l)C05 


MESSAGE "NOT A CHARflOTER STRING" 






1/0006 


GCTC 2 






1/0007 


1 G0T0,ATT(A,7).EC.l 3 






l/3(*b8 


MESSAGE "t-OhE THAN i ELEMENT PASSED" 






l/3d09 


2 EXITP 3 






1/0010 


3 EKOF ATTIAIl),6).ES.-3 






1/0011 


I CENT 






1/0012 


GEN CHAR_CCUhT<"CHARACTER") 






1/0013 


GEN CHAR_CCUKT(123<i5) 






1/001% 



GEN CHAR.CCUNT l"ST AR~,~ASSEMBi.ER"l 

GEN CHAR_CCU|kTriiriAT",,,"FOR") 

END 
CHARACTER_STRING_SI2E.FLMCTI0N 

FINIS 



OATEI 12SEP7* 
DATE! 1?SEP7% 



PAGE 
PAGE 



ASScMBLY FINISHED 
3116 P.M. THURSOAr 12TH. SEPTEMBER, X<il»** 
NUMBER OF STATEMENTS PROCESSED <t3 
NUMBER OF WARNING MESSAGES NONE 
tiUHUbR OF ERROR MESSAGES NONE 



1/0C15 



1/0016 



1/J017 
3 



I* 
1/0018 



Example 4. ATT Directive 



In the first GOTO statement, (A[l],2) specifies a mode check on the first element of set A. If this element 
is a character string, the value 7 is retumed. (See Intrinsic Attributes in section 5.) If the first element of 
set A returns a mode value of 7, statement 1 is processed next. Statement 1 also contains an attribute refer- 
ence ATT (A,7). This reference specifies the 7th attribute of the value assigned to A is to be determined. The 
7th attribute requests the number of elements. If > 1, a message is given; if = 1, statement 3 (ENDP) is 
processed. This statement requests the number of bits assigned to the first element of A shifted right, .BS,-3, 
3 places and retumed to the call statement (the hexadecimal value 48 assigned to the first element of A 
(CHARACTER) shifted right results in the value 00000009 across from the GEN statement. 
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REFERENCING SYMBOLS 

Example 5 illustrates the assembly time problem solving capability and the means of referencing a symbol 
defined with two different values. 



I coc ^T*p *3::cMaciK vcr 


2.2.2 








OATEI 


t2SCP7% 


PACE 


1 


a 






INPtT 
OLTFUT 


itao 








l/}b01 
l/aGU2 


wti 


0^00001*032 


e 

SQUAKE 

AGAIh 

KESULT 


RCEF 

ICENT 

FLNC 

NAHE 

NAME 

RCEF 

ENOF 


50 
NUH8ER 

NUN8ER[ll*»iUHBERCll 

RESULT 








i/ai.03 

1/J00<» 

l/iuJ5 

i/joae 
i/jQor 

1/^068 
l/0b09 


00 


UiUuC00319 


8 


RCEF 


25 








i/ooia 


Ui. bltiybwuubd F \Hi,UiiiiU 


Oiiaaczn 


C 


GEN 


SQUAKE (B) 








i/jati 


iiJ 


ULSauOU032 


C 


RCEF 


as 








i/aoi2 


1^1 CllblOjOftb F JdgGbJbb 


000ttb9C4 




GEN 
END 


AGAIMO 








1/0013 
l/001«i 


1 CDC STAR ASSErtdLcR VER 


2.2.2 








DATEI 


12SEP7* 


PAGE 


2 


UNUMBtR OF WARNING MtSSAGES » 
















NUH8ER OF EiiRJR MESSAGES 


» 
















I COC STAK ASSEHBLcR VER 


2.2.2 








DATEI 


12SEP7« 


PAGE 


3 


d 






FINIS 










l/OfllS 



it 

a 

b A3SEH3LY FINISHED 

tt 3138 P.M. THURSOAV 12TH. SEPTENBER. 197<». 

3 NUHScR OF STATEMENTS PROCESSEC 19 

«1 NUMBER OF WARNING MESSAGES NONE 

9 NUMBER OF ERROR MESSAGES NONE 

1 



Example 5. Referencing Symbols 



The label symbol B is defined with hexadecimal values 32 and 19, and these values are separately passed to 
function definition (SQUARE). During the first call to SQUARE, the value of B (19) is passed to the function 
definition set Ust (NUMBER). The result of the function is retumed to the function call level. 

Even though there is only one list element in the NUMBER set list, the element must be referenced in the 
RDEF directive by specifying the element location in [1] brackets. Prior to the second call, the value B is 
redefined with the value 32. To redefine B, with this value, a $ is appended. The $ instructs the assembler 
to look for the new value at the Universal level. 



CONVERSION FUNCTIONS 

ITOC and HTOC conversion function, programmed as part of the assembler, are used in example 6. The ITOC 
call (line 12) converts an integer string constant (line 7) to a character string constant. The HTOC call (line 15) 
converts a hexadecimal constant (line 8) to a character string constant. Notice the manner in which the calls 
are written: 



specifies the set element 



ITOC (I[K]) to be converted 

t 



specifies the set 



The HTOC call is written in the same manner. 
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1 COC STAR ASSEHetCR VER 2.2.2 



DEC 
01 wktabQUiiliO F 313<(3Q37 33373i»3S 
CI filbbuOUC<»0 F 33333535333237 



OATCI 12Sei>r% PAGE 1 

INPUT iiSOii . 1/aoot 

OtTFUT 1/0002 

*TITLE - ASSECBLEf! CONVERSION FUNCTIONS 1/0003 

I SET ]iiO737<iSe3;5327.-l>iOr37<»a0355327t-256f256fl*-ltOt-Of<»O96t-<»O96 l/aOti% 

H SET #FFFFFFFFFrFF,-#FFFFFFFFFFFF,-#F»iFtiOt-»il»#l.-#l.»ai23*56789iV 1/0005 

-•(il23«5E7e9««A8C0EF,-IAeCCEF 1/0006 

ICEWT 1/OflOf 

10 K RFTtlO 100 1/0008 

GEN ITOCfl(KJ) • 1/0009 

......... ...... — •• 1/1010 



100 



MESSAGE 



Jl uLCuCua;,78 C ^0313<»30 3733373>i 
Ji uLCCbCi:jB8 C 33383335 35333237 

01 ul«<liCauuF8 C 20323536 

<iX CkOubgdlie C 323536 

01 uCuuwubioQ C 3i 

til liL(.uul.J138 C 2031 

CI uCC0uUul<»8 C 33 

4l 8bCH(iO<il5(i C 33 

111 OlCi.(.Ctfl58 C 3<4303936 

AX bCCtCt»ul78 C 203<*303936 

DEC 12 

Gl CllOL&ulAu H '»e><«6't&<i6 ^6(f6<t6(»6 

iX GlCuuUJZUa F 333C303J 30303330 
ul uC0uju^2(«b F 3]3&3C31 

dl bCC;3kuu26J H <»&(«6(tb'46 <»6<»6<»6<i6 

ul ulCuCC^^bu H 't6<46i«631 

il uCLJwUaZCC F 3J303d3Q 30303330 
Ul Qi,b;i;.Uu3jO F ZjiiSiikb 

«1 («Ciiii..rfu32ii H JJ3(>3030 303113030 
^1' bli.uu(;a3&ii H 3a3C3u30 

41 OlCCbObSSli F 3J3b3J30 3u3G3030 
'<ii itHi'^vuiiiCu F 3jJl3u30 

01 ultULiiJ3E0 H 30JC3&30 30303030 
Ml wl.(<i:wu<t20 H JJ303031 

Jl wCi.uw0ii<4<»t] F t&i»6<»&'*6 <»6'i6<»646 
ai u(.ObuOj'»Bu F '*6i«6<»6<»6 

1 COC STAR ASSEMBLER VER 2.2.2 
001 0(.CbuOG<fAJ H 33303031 32333<t35 
lit bbOC^tOCtEu H 3o373839 

01 CCbJJtiJ5'*b F 39383737 



RFTflZ 101 

GEN HTOCtt-Ihl) 



101 



MESSAGE 



1/0011 
1/0012 



1/0013 



OATEI 12S£P7<» PAGE 



ul OkUb.CaSbb H 3i]3Ci3b30 3ii30(»l<»2 
lil blbSu6u5AU H <t3<»(»<t5't6 
•♦•♦•♦••♦»♦••♦♦♦••••••♦• 

CI OlbubuQ5Cu F i«6'«6'»6i«6 <»6<«6353<» 
01 lj(.t.uuuue)bb F 33323131 



END 



FINIS 



1 COC STAR ASSEiaiER VCR 2.2.2 

OhUHBER OF MARNING HESSAGcS > 

NUMBER OF ERROR MESSAOES = 

1 COC STAR ASSEHBLtR tf£R 2.2.2 


a 



S ASSEMBLY FINISHtO 

3l2»t P.M. THURSDAY 12TH. SEPTEHBERt 197*.- 

It NUMBER OF STATEMENTS PROCESSED Sk 

i NUMBER Of MARKING MESSAGES NCNE 

S NUMBER OF ERROR MESSAGES NONE 

1 



OATEi 12SEP7<> PACE 
OATEI 12SEP7* PACE 



1/001% 
3 



i/aii5 



Example 6. ITOC Function 
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SYMBOL CREATION 

In example 7, a symbol is generated in the fourth line of the PROC definition. The result generated is R 
(without quotes) concatenated to the value of N. The 1 following ITOC(N) specifies a $ be appended to the 
symbol. 

The result of the procedure call generates the following: 

Rl GEN 1 



R20 



GEN 20 



1 COC STAR ASSEMBLER VER 2.2.2 














OLTFUT 












TITLE "SYHBCL CREATION" 


1 COC STAR AS 


iEHBLER VER 


2.2.2 


SYMBOL 


CREATICN 













ICEKT 












PROC P 










GENROEF 


NAME 










N 


RPTtPIZl 10 










10.SYN(P[l].CAT.ITOCfN>,l) GEN N 












ENDP 


ill cciuuQOuja 




ojbbCijja 


OJb JuOOl 


CALL 


GENfiDEF -R-,20 


a u(iUiluwdu'<»J 




33i(iil< JiiO 


Ubuju0l<2 






bl blCukCULau 




OOuCu jbC 


UutiJiiUil3 






Ut Ol(iuCO(<>lCv> 




ajbOu3ua 


UuJbb03ii 






01 OCbCLCJlJO 




OdbCu J Ji;. 


tiOCuGbOS 






at b(.CuLCjl(«C 




i^'jiijiJC 


OuQ^uwOb 






111 0Cl.dL0U163 




Jk jOC juU 


au^uuoG? 






lit klCJbujlCu 




uJjOuu JO 


ObOCiUtiba 






Jl UkUJkiJQ^uj 




JCububO 


uubbtOUJ 






lit aLb.i)GJ2<4(i 




OUObliOJO 


bOuCbCOA 






01 OltJCUj28b 




g juCObuu 


JjU jbbCB 






Ul CiLI.;i»bJ2Cii 




J Jubii O^U 


OwuSCyUC 






dl d(.bCo(..3JQ 




JUQCOiJUO 


jQGObuOO 






ul uLlk;bUj3i«0 




jjUOuJgO 


(j&JuUuUE 






01 oLC0bu038u 




JubC jbu 


UbJiibO&F 






it SL0uiiaj3CG 




ujacico^o 


OuUbOtilO 






ul iil»tu*tGZi*!iii 




dOwCbOQC 


aujOQQll 






01 ^ICuLdu't'tO 




OjOuCSJC 


(iuUi.bbl2 






01 U(<Cwkb4<*at< 




J JtCL^Jb 


QCibQCU13 






ul ulbbubu<»CC 




OJUCuOOG 


Oi«JuOCl<» 




EKO 


1 COC STAR AS 


JEHBLER VER 


2.2.2 


SYMBOL 


CREATION 


ONUHBER OF WARNING MESSAGES = 






NUMBER OF ERROR 


MESSAGES 


3 






1 COC STAR AS 


JEMBLtR VER 


2.2.2 
















FINIS 


a ASSEMBLY FINISHED 






a 3126 P.M. THURSDAY 12TH. 


SEPTEMBER, 


1»7*. 


i NUHB 


ER 


OF STATEMENTS PROCESSEC 33 




• NUMBER 


OF WARNING MESSAGE 


£ NONE 




NUMBER 


OF ERROR 


MESSAGES 


NONE 





DATEl 12SEP7% PAGE 



OATEt 12SEP7% PAGE 



OATEI 12SEP7II PAGE 
OATEI 12SEP7i» PAGE 



1 

1/0001 

1/0002 

2 

1/0003 

l/000ii 

1/0005 

1/0006 

1/0007 

1/0008 

1/0809 



1/8010 
3 



4» 
1/0011 



Example 7. Symbol Creation 
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' EXECUTABLE EXAMPLES 

The following examples include the use of machine instructions, specifically, in the area of vector programming. 
They are provided to aid in understanding the types of machine instructions available with the STAR compute!- 
system. For a description of the register conventions illustrated in these examples, see appendix E of the STAR 
OS Reference Manual, Publication No. 6038400. 



USING VECTORS 

Vector can be created through the GEN directive or by the INTERVAL machine instruction. To create a 
vector, the programmer must set up a descriptor specifying the length of the vector and the base address 
(points to the first element of that vector). This descriptor is created in a register the programmer selects in 
the following order: 

base address An EX instruction for 64-bit register clears 64 bits and enters the base address of 

the vector specified. 



length 
Example: 



An ELEN instruction for 64-bit register enters the length in bits 0-15 of the register. 



A 



INPUT 




OUTPUT 




IDENT 




MSEC 


2 


EQU 


#lA"6if 


EX 


A,AVECTOR 


ELEN 


A. 9 



MSEC 



AVECTOR 



GEN 



1,2,3,4,5.6,7,8,9 



END 
FINIS 
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Register #A1 




15 



64 



0009 



Address Points to AVECTOR 



length 



— base address (element 1) 



In specifying a register, the user must include the register number times 64 or 32 to specify its size. As 
described in the STAR Hardware Reference Manual (see Preface), the first half of the register file can be 
referenced as 128 full-word registers or 256 half-word registers; therefore, full-word register IE and half-word 
register IE are different. 



VECTOR ADDITION 

The examples which follow illustrate three methods of vector addition: 

add index vector 

add sparse vector 

In each example, the vectors are either created differently or the vector descriptors are created with different 
statement types. The STAR machine is primarily a vector oriented machine, therefore, the use of vectors 
whenever possible results in savings to the user. 



INTERVAL 

The INTERVAL statement is a vector macro which executes as follows: The first element created is the value 
designated in the A source element in the operand field. This value is placed in the C element. 

INTERVAL qualifiers A, B, C, Z 

(see machine 
instructions 
appendix C) 

A constant in source operand B is added then to the value of A to form the second element of C. The third 
to N elements of C are formed by adding the constant in B to preceding element C. The length of the result 
vector is specified in the descriptor of the result vector. 

A C 

A to C 
A + B to C 
B + C to C 
B + C to C 



1 




.. 


•. 


1 






\ 


B 




\ . 


1 


s 


2 










3 

4 
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The qualifiers and Z field, which specifies the constant vector, are not used in the following example and are 
not discussed here. Control vectors and qualifiers are are illustrated in example 8 which follows. 



CDC STAR ASSEHSLER V£R g.2«2 



X COC STAR ASSEMBLER VtR 2.2.2 


az ocoibooaoo 



00 

uo 

06 
00 
Oii 
OG 
liO 
a£ii2G0gU 
BE'iObl.ju 



(tOuOOfaUaO 

dUuODClOSO 

UOJui;(jOai<i 

0(jaG0u07i»0 

auuObi)G5<»0 

00u00u06d0 

050GO0OO 

UUUOCCOl 



j2 uGbauQu'j<«a F 

az ocbuMOOaea f 

il<; bbbbtjOwCAtt H 2A(«20Cll>» 

02 btuuuudbCa F oFiiUbU'to aj<»iao<i2 

az bbbjiiuJibo F 7Jioi5ao 

02 OCbi^COOlZu H 36i.uCulA 



lh,PU l.OCtl 
OLTFUT 
TITU "CREA 
CREATE VECTCRS VIA 
ICEKT 



IE VECTORS VIA INTERVAL* 
INTERVAL 



OATEI 12SEP7b PAGE 



OATEI 1ZS£P7% PACE 



A 

e 
c 

N 

PSP 

VITAL 

RTRN 

START 



HSEC 

EKTRY 

ECU 

ECU 

ECU 

ECU 

ECU 

ECU 

ECU 



2 

STAR 

*i*2* 

20 

tiO* 

#i5» 

#1A» 



• THESE REGISTERS CONTAIN 

• SOLRCE ELEMENTS 

• CONTAINS RESULT VECTOR DESCRIPTOR 

• LENGTH OF RESULT VECTOR "C" 

» 

♦•• ENTRY SEQ 



EX C.f?UObO 
EX A,l 
RTOR A, 8 * 
ELEf. C,N • 
INTERVAL A, 
S»>AF PSPtVI 
8SAVE iRT 
EKO START 
CREATE VECTORS VIA INTERVAL 



1 COC STAR ASSEH8i.ER VER Z.2.Z 

CKUrOER OF WARNING MESSAGES s 

NUMBER OF ERROR MESSAGES » 

i COC STAR ASSEMBLER VER 2.2.2 

« FINIS 



a 

ASSEMBLY FINISHEO 

U 3128 P.M. THURSDAY 12TH. SEPTENBERt i97'». 

NUMBER OF STATEMENTS PROCESSEQ 22 

NUMBER OF WARNING MESSAGES NCNE 

fl NUMBER OF ERROR MESSAGES NONE 

i 



TRAhSflTS VALUE 1 TO 8 SOURCE 

VALLE 20 ENTERED INTO LENGTH PORTIOK OF C OESC. 
E.C 'CREATE VECTOR C 
TAL 
RN 

OATEI 12SEPt« ' PAGE 



OATEI t2SEP7« PAGE 



1/0001 
1/0002 
1/J003 
2 

i/abb<» 

1/0005 
1/0006 
1/0 7 
l/OJOS 
1/0009 
1/0010 
1/0011 
1/0012 
1/0013 
1/001% 
1/0015 
1/0016 
1/0017 
1/0018 
1/0019 
1/0020 
1/0021 
3 



1/OOZZ 
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ADD INTERNAL VECTORS 

Example 9 illustrates the use of the INTERNAL macro in generating vectors, the ADDXV instruction, and the 
use of dynamic space. Also illustrated is the standard entry sequence that should be followed in user programs. 
Since this subprogram is not called by other routines and does not call any other routine, the entry sequence 
illustrated is not required. The assignment of the DSP_R register is required, as the results will be entered into 
the dynamic stack area. Before reading this example, read the Register Conventions in appendix E of STAR OS 
Reference Manual which provide a description of the register file and the use of the pointers specified in the 
entry sequence. 

In this example, the initial source values are specified by the EX instructions which enter a value of 1 into bits 
16-63 of register A and a value of 3 into bits 16-63 of register Bl. 



Descriptors for the resultant vectors CI, C2, and C3 are then created; length specified is 100 decimal full-words; 
base address is set at some virtual location in the user available dynamic stack (the locations for vectors CI, C2 
and C3 are sequential and 100 full-words apart). Vectors are created by the INTERVAL macro's and then 
summed by the ADDXZ instruction. For a description of the working of the INTERVAL instruction, see 
example 8 in this appendix. 



COC STAR ASSENaLER VER 2.2.2 



COC STAR ASSEMBLER V£R 2.2.2 



02 Ol0li(OOOaO 



C2 aiOCbOU030 
32 bt«.J»bwwOu 
«i2 •lLC(,0.,u2J 
u2 kiiLiujttdhQ 
02 a(.Cy;.0gU6il 
C2 OcCUiiObbBtl 
Olb^CGutCu 
OkCubOQliJu 

UC dCbOw 160 

JlbbuO: ICu 
t. C (i b b C 2 J U 
OIC Jb3v<:2<J 

CCbwO00260 

UCCJbOQ2Cu 
02 bl(i.ibUu3CU 
a2 uHt!t(.<i J ikii 
02 uCbwM0u36G 



00 
00 
JO 
uU 
JO 

tfti 

uO 
bO 

CO 

F 

F 3E15b01A 
H /JJtlSlC 
F raiCgJiO 
H 731BCJXC 

F 3Fiocoao 

F d£<«J03'Jb 
F Ti'tiiiQit'* 

H 3F<«««igao 

F TihUi.H'iB 
H 3F'«519jtt 
F 8c'«bCa.iO 

F ae^^ooau 

F 2A'*3a06if 

H 2a'«<»au6<* 

F 2A'45u06<» 
H ruiiSiO^hl 

F OF;iObu'ib 

F OFbbiJb'«0 

F 93duUC(«3 Oi)if<»CG<t5 

F fUlOlSbO 

H 3&bbbwlA 



GOuOOOIOjO 

ouooooij*»a 
ooodCuioao 

bbOLUblOCO 
OduubOllJO 
0;.COOU11'»0 
uu;iOui.bS(»G 
ObU;iuOb630 
0uJbwbU6C0 

uOwOboorab 

O0000007<i0 



Otiao<»Boa 
osoooooo 



GUOObbOl 
00000003 



U0<»lb0<t3 

oa(f20o<f'» 



1 COC STAR ASSEMBLER VER 2.2.2 
ONUNBER OF WARNING MESSAGES > 
NUMBER OF ERROR MESSAGES « 
1 COC STAR ASSEMBLER VER 2.2.2 

C 


a 

ASSEMBLY FINISHED 

SIS'! P.M. THURSDAY 12TH. 



OATEt 12SEP7i» PAGE 
IKPLT i,ac.i 
OLTFUT 

TITLE -INTEPVAL/ AOCXV WITH REGISTER FILE USAGE SEQUENCE- 
INTERVAL/ ACOXV HITh REGISTER FILE USAGE SEQUENCE OATEl 12SEP7% PAGE 
ICEhT 



MSEC 2 
ENTCY START 



A 

81 

62 

CI 

C2 

C3 

VITAL.R 

RT N 

CSP.fi 

CSP_R 

PSP_fi 



ECU 
ECU 
ECU 
ECU 
ECU 
ECU 
ECU 
ECU 
ECU 
ECU 
ECU 



#<»l»6<i 
#«»3*6«i 

ffl5*6ii 
#lA»6<k 

• ia»6«i 
#lC»6<i 

• 10*6 <i 



• POINTS TO ENWIRONMENT REGISTERS 

• OVMArtIC SPACE POINTER -POINTS T3 

• CLRRENT STACK POINTER -POINTS TO 
PliEVIQUS STACK POINTER 



NEXT AVAILABLE FREE 
REG FILE STORAGE 



••♦• ENTRY SEQLENCE •••♦ 
START 

ES . VITAL_C^«IA 
ShAP ,VITAL_R,CSP_R 
RTOfi CSP_R,PJP_R 
RTOR CSP_fi,CSF R 
m CSP_Rf 200»6<» 
EX Cl.fSOCOCOO 
RTOR CI, 02 
IS C2|100*6« 
RTOR C2,C3 
IS C3,tbU«&« 
EX A.l 
EX E2,3 ' 
ELEN CI. ICO 
ELEK C2,1C|) 
ELEN C3«1C0 
RTOR A,B1 
IKTERVAL A, El, CI 
I^TERVAL A,E2.C2 
ACOXV C1,C2,C3 

ShAF PSF_S,WITAL_R 

8SAVE ,RT_t> 

E^0 START 

INTERVAL/ ACOXV MIT»- liECISTER PILE USAGE SEQUENCE 



•CURRENT STACK POINTER EQUALS PREVIOUS 
•CURRENT STACK POINTER EQUALS DYNAMIC 
•SAVE STACK FRAME SIZE IS 3Jb MOROS 



•SET C2 ICO FULL MOROS AFTEil CI 
•SET C3 IbO FULL MOROS AFTE4 02 
•SET B3 TO 3 



•PLACE VALUE 1 IN Bl 



NUMBER OF STATEMENTS PRQCESSEO 
NUMBER OF WARNING MESSAGEs'^NCNE 
NUMBER OF ERROR MESSAGES NONE 



FINIS 



SEPTEHBERt 197<i. 



OATEl 12SEP7% PAGE 



OATEl 12SEP7% PAGE 



1 

1/0001 

1/0002 

l/0b33 

2 

l/ObOd 

1/0C05 

1/0006 

1/0007 

1/0008 

1/0009 

1/0010 

1/0011 

1/0012 

1/JU13 

l/001<i 

1/001$ 

1/0016 

1/0C17 

1/0018 

1/0019 

1/3020 

1/0C21 

1/0022 

1/0023 

l/002<i 

1/002$ 

1/0C26 

1/0027 

1/0028 

1/0029 

1/0030 

1/0031 

1/0U32 

1/0033 

1/003^ 

1/0035 

1/0036 

1/0037 

1/(038 

1/0039 

l/00<iO 

1/00^1 

3 



i/ia%z 



I-IO 
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0020000 OOOQOQOQ 00000001 00000000 00000002 00000000 00000003 00000000 00000()0<» 

0020100 00000000 00000005 00000000 00000006 00000000 00000007 00000000 00000308 

0020200 00000000 00000009 00000000 OOOOOOOA 00000000 0000300B 00000000 00000)00 

0020300 00000000 00000003 QOOdOOOO OOOOOOOE 00000000 OOOOOOOF 00000000 00000010 

Q02i)i»00 OOOQOQOO 00000011 UOOOOOOO QQQ00012 OOOQOQGO 00000013 uQOOQQOO OQQQuJlH 

0020500 00000000 00000015 00000000 00000016 00030000 00000017 00000000 00000316 

0020600 00000000 00000019 00000000 OOOOOOIA 00000000 OOOOOOIB 00000000 0000031C 

0020700 00000000 00000013 00000000 OOOOOOIE 00000000 0000031F 00000000 0Q000J20 

0020800 00000093 000000?1 00000000 00000022 00000000 00000323 OOOOOOOQ 0000032'* 

0020900 00000003 00000025 00000000 00000026 00000000 00000027 00000000 00000328 

002aA00 00000000 00000029 00000000 a000002A OOOOOOOQ 00000023 OOOOOOOQ 0000032C 

0020300 OOOOOOOQ 00000023 30000000 0000002E OOOOOOOQ 0000002F OOOOOOOQ 000003 30 

0020000 00000003 00000031 OOOOOOOQ 00000032 00030000 00000033 OOOOOOOQ 0000033^ 

0023300 OOOOOOOQ 00000035 OOOOOOOQ 00000036 OOOOOOOQ 00000037 OOOOOOOQ 00000333 

0020E0Q OOOOOOOQ 00000039 00030000 0000003A OOOOOOOQ Q0QG3Q38 OOOOOOOQ 0Q00333C 

0020FOO OOOOOOOQ 00000033 00000030 0000003E 00300000 0000003K OOOOOOOQ 000003<+0 

0021000 OOOOOOOQ OOOOOQttl OOOOOOOQ 000000^2 OOOOOOOQ 000000^3 00000000 OOOOOOtft* 

0021100 OOOOOOOQ 0000001*5 OOOOOOOQ 000000^6 00300000 000000<t7 OOOOOOOQ 000003^8 

0021200 OOOOOOOQ OOOOOQifg 30000000 000000<tA 00030000 OOOOOQitS OOOOOOOQ 000Q03<fC 

0021300 OOOOOOOQ 000000^*3 3003QQ00 300OOO'*E OOOQOQOO OOOOOOOF 00000000 00000350 

0021tfOO OOOOOOOQ 00000051 OOOOOOOQ 00000052 OOOOOOOQ 00000053 OOOOOOOQ 0000035^* 

0021500 OOOOOOOQ 00000055 00000003 30000056 00000300 00000057 OOOQOQOO 00003358 

0021600 00000003 00000039 OOOOOOOQ 0000005A 00330000 00000053 03030333 30000350 

0021700 OOOOOOOQ 00000033 00033003 300Q005E OOOOOOOQ 0000035- 03000333 00003]o0 

0021800 OOOOOOOQ 00000361 30033000 30000062 OOOOOOOQ 00000363 OOOOOOOQ 0000036^ 

0021900 00000003 00000001 00030000 OOOOOOOt* OOOOOOOQ 00000007 OOOOOOOQ OOOOOSOA 

0021A00 00000003 00000003 OOOOOOOQ 00000010 OOOOOOOQ 00000013 00030003 00003316 

0021330 03000000 00000019 30030030 33300010 OOOQOQOO 0000031F 03000333 00003322 

0021000 OOOOOOOQ 00000025 OOOOOOOQ 00000028 00300300 00000023 OOOOOOOQ 0a00332E 

0021300 OOOOOOOQ 00000031 OOOOOOOQ 0000003<* 00000030 00000037 OOOOOOOQ 0000033A 

0021E00 OOOOOOOQ 00000030 00000003 333000t*0 OOOOOOOQ 000000^3 03000030 000003^*6 

0021F00 OOOOOOOQ 0Q0000t»9 OOOOOOOQ 000000<fC 00330000 OOOOOOUF OOOOOOOQ 00000352 

0022000 00000003 00000055 00030030 33000058 00330300 0000035B OOOOOOOQ 000Q335E 

0022100 OOOOOOOQ 00000061 00000000 000Q006<» 00330300 00000067 OOOOOOOQ 0000036A 

0022200 03000000 00000053 33030003 30300070 00300300 00000073 OOOOOOOQ 00000376 

0022300 OOOOOOOQ 00000079 00030000 0000007C OOOOOOOQ 0000007F OOOOOOOQ 00000382 

0022<fOO OOOOOOOQ 00000085 OOOOOOOQ 00000088 00330000 00000083 OOOOOOOQ 0000338E 

0022500 OOOOOOOQ 00000091 30030003 3000009^* OOOOOOOQ 00000397 OOOOOOOQ 0000039A 

0022600 00000030 00000093 00003033 Q33000A0 30030000 000000A3 OOOQOQOO 0QQ003A6 

0022700 00000033 00300049 OOOOOOOQ 303003AO 30330000 OOOOOOA- 03033333 33333)32 

0022300 OQOOOOOO 00300035 OOOOOOOQ 00003088 00300300 000000B3 03030003 0000Q3BE 

0022900 OOOOOOOQ 00000031 OOOOOOOQ OOOOOOC<t 00300000 00000007 OOOOOOOQ 000003OA 

0022A00 OOOOOOOQ 00000033 00030000 OOOOOOOQ OOOOOOOQ 00000003 03000003 00000306 

0022300 OOOOOOOQ 00000039 OOOOOOOQ 300000OC 00030000 OOOOOOOF OOOOOOOQ 000033E2 

0022000 OOOOOOOQ 0O000QE5 30030000 000000E8 00300300 00O0OOE3 OOOOOOOQ 000033EE 

0022000 00000030 000000-1 OOOOOOOQ OOOOOOFi* 00330000 OOOOO0F7 03000333 000003FA 

0022E00 OOOOOOOQ 000000'='3 OOOOOOOQ 00000100 00030000 00000103 00000003 00000106 

0022F00 00300003 00000109 00000003 33303130 33333030 0000010* OQOOOOOO 00003112 

0023000 00000033 00000115 00000303 03300118 03330000 00000113 OOOOOOOQ OOOOQllE 

0023100 OOOOOOOQ 00000121 00030003 0030012^ OOOOOOOQ 00000127 OOOOOOOQ 0O000L2A 

0023200 aOOOOOOO 00003002 30030333 33003035 00000300 0Q03030A 03000003 0000030E 

0023300 03000000 00000012 OOOOOOOQ 0OU00O16 UOOOOOOO OOUOOOIA 00030003 0000031E 

0023t»00 OOOOOOOQ 00003022 00000033 33800026 OOOOOOOQ 0000002A 03000000 0000032E 

0023500 00000003 00030032 QOCOOOOO 00000036 03330300 0000003A 00000003 0000033E 

0023600 00000003 000000(*2 00030000 300000<t6 03330000 OOOOOOIA 00000333 OOOOOJ^iE 

0023700 OQOOOOOO 00000052 00000033 00000056 OOOOOOOQ 0OOOOQ5A 03000333 Q000035E 

0023300 OQOOOOOO OO0OOOS2 30030000 00000066 OOOOOOOQ 0000036A 00000003 0000036E 

0023900 00000033 0030007? 30030003 00000076 00003000 0000037A OQOOOOOO OO000J7E 

0023A30 00000003 00000032 00033333 33303386 OOOOOOOQ 0000008A 00000033 30303)SE 

0023300 00090033 00000092 OQOOOOOO 33000096 33333300 0000009A 00000300 0000339E 

0023000 OOOOOOOQ OOQ000!V2 30030033 300000A6 OOOOOOOQ 000003AA 00000300 000033AE 
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0023000 00000000 00000032 00000000 00000086 00000000 OOOOOOBA 00000300 0000038E 

0023-00 00000000 000000C2 00000000 O000O0C6 00000000 OOOOOOCA 00000333 aOOOfl)CE 

0023F00 00000000 00000302 00000003 00000006 00300000 OOOOOOOA 0O.«OO000 0000030E 

802'»000 00000009 O0B000E2 00000000 00000OE6 30330300 OgOOOOEft 00000000 OOOOOJEE 

002!*100 00000000 000000-2 30000000 000003-6 00330000 OOflOOOFA 00000000 O0000)-E 

002«»200 00000003 00000102 00000000 00000106 03300000 OOOOOIOA 00000000 OOQOOIOE 

002!f300 00000003 00000112 30000000 00000116 00000000 0000011ft OOOOOOOO OOOOOllE 

002<»<»00 OOOOOOOO 00000122 OOOOOOOO 00000126 OOOOOOOO 0000012A OOOOOOOO 00000t2E 

002«»500 OOOOOOOO 00000132 00000003 00000136 OOOOOOOO 0000013A OOOOOOOO 0000013E 

002«»600 OOOOOOOO 000001«»2 OOOOOOOO 000001'»6 OOOOOOOO 000001i»A OOOOOOOO 00000l'»E 

002'»700 OOOOOOOO 00000152 OOOOOOOO 00000156 OOOOOOOO 0000015A OOOOOOOO OOOO0L5E 
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